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About This Manual 


This guide provides information on shutting down and starting up your system and 
identifies the processor-specific boot commands for the processors supported by the 
ULTRIX operating system. It also provides a description of the standalone ULTRIX 
environment. 


Audience 

The ULTRIX Guide to System Shutdown and Startup is written for the person 
responsible for managing and maintaining an ULTRIX system. It assumes that this 
individual is familiar with ULTRIX commands, the system configuration, the 
system’s controller/drive unit number assignments and naming conventions, and an 
editor such as vi or ed. You do not need to be a programmer to use this guide. 


Organization 

This manual consists of four chapters, two appendixes, and an index: 


Chapter 1: 
Chapter 2: 

Chapter 3: 

Chapter 4: 

Appendix A: 

Appendix B: 


Explains the various ways that you can shut down the system. 

Explains the three modes that you can use to start up the system: 
single-user, multiuser, and conversational (VAX only). 

Identifies and describes the boot commands supported by the ULTRIX 
system. 

Describes the purpose and functionality of the Standalone ULTRIX 
Environment and explains how to invoke it. 

Lists the supported device mnemonics and explains how to obtain 
detailed reference page information on devices. 

Shows how the VMB program uses the general purpose registers. 


Related Documentation 

You should have the hardware documentation for your system and peripherals. 

Conventions 

# A number sign represents the superuser prompt. 

% cat Boldface type in interactive examples indicates typed user input. 

file Italic (slanted) type indicates variable values, placeholders, and function 

argument names. 




cat(l) 

Ctrl/jc 


In syntax definitions, a horizontal ellipsis indicates that the preceding item 
can be repeated one or more times. 

A cross-reference to a reference page includes the appropriate section 
number in parentheses. For example, cat(l) indicates that you can find 
information on the cat command in Section 1 of the reference pages. 

This symbol indicates that you hold down the first named key while 
pressing the key or mouse button that follows the sl ash. In examples, this 
key combination is enclosed in a box (for example, I Ctrl/C I \ 
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System Shutdown Procedures 


1 


On occasion, routine system maintenance may require you to shut down your system. 
The exact shutdown procedure that you use depends on whether you want to shut 
down multiuser mode and remain in single-user mode, shut down and halt the 
processor, or shut down multiuser mode and reboot. This chapter explains all of 
these procedures. 


1.1 Shutting Down Multiuser Mode 

There are three steps for shutting down multiuser mode and staying in single-user 
mode so that you can perform routine system maintenance. Steps 2 and 3 are optional 
and depend on the type of system maintenance that you want to perform. The steps 
are: 

1. Use the shutdown command to bring the system to single-user mode. For 
example: 

# /etc/shutdown +15 'to install new devices' 

This will shut down the system to single-user mode in 15 minutes. The 
shutdown command logs the specified reason (shown within single quotation 
marks (‘’)) in the /usr/adm/shutdownlog file. Then, it notifies current 
users of the impending shutdown. It also creates an /etc/nologin file five 
minutes before the shutdown occurs, to prevent users from logging into the 
system. At the designated time, the shutdown command shuts down multiuser 
mode. 

When the system displays the superuser prompt (#), the system is back to single- 
user mode. The system console is open with the superuser account active. All 
other terminals are disabled, but all file systems are still mounted. You may now 
want to unmount file systems or you may want to halt the processor. 

When you restart multiuser mode, the /etc/rc script automatically removes 
/etc/nologin to reenable user logins. 

2. Unmount file systems. If you want to, you can now unmount the file systems. 

To unmount all file systems, use the umount command with the -a option. You 
must be in the root (/) directory before you issue the umount command. For 
example: 

# cd / 

# /etc/vimount -a 

This command unmounts those file systems named in the /etc/f stab file and 
leaves only the root file system mounted. If you have mounted a file system that 
is not defined in /etc/f stab and you want to unmount it, use the umount 
command and specify the file system’s special device name. You can tell if a file 




system is mounted by typing: 
# /etc/mount 


When specified without options, the mount command displays the currently 
mounted file systems. For example: 

/dev/rzOh on /usr/staff type ufs 
/dev/r 22 c on /usr/staff/rl type ufs 

sysname:/usr/staff/a2 on /usr/staff/a2 type nfs (rw,soft,bg,nosuid) 


To unmount the /usr/staff file system, use the umount command as shown 
in the following example: 

# /etc/umount /dev/rzOh 


Notice that, to unmount the /usr/staff file system, you must unmount the 
device on which it resides. In this example, /usr/staff resides on the h 
partition of the rzO disk. 

For more information on both the mount and umount commands, refer to 
mount(8) in the ULTRIX Reference Pages. 

3. Halt the system. After you have issued the shutdown command, you can halt 
the system with the halt command. (Depending on your processor type, the 
system will either halt itself, or it will direct you to halt the system.) For 
example: 

# /etc/halt 

syncing disks ... 


» 

The halt command stops the processor and the console monitor prompt is 
displayed. You can now boot the system to single-user or multiuser mode as 
described in Chapter 2. 

When your system is in single-user mode, you can proceed with the desired 
maintenance procedure. 


1.2 Shutting Down and Halting the System 

To shut down multiuser mode and halt the processor, use the shutdown command 
with the -h option specified. For example: 

# /etc/shutdown -h +10 'scheduled maintenance' 


This will shut down and halt the processor in 10 minutes. The shutdown command 
logs the specified reason (shown within single quotation marks (”)) into the 
/usr/adm/shutdownlog file. Then, it notifies current users of the impending 
shutdown. At the specified time, the shutdown command shuts down multiuser 
mode and halts the processor. 

When you restart multiuser mode, the /etc/rc script automatically removes 
/etc/nologin to reenable user logins. 

The halt command provides an alternative shutdown procedure and should only be 
invoked from single-user mode. 
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Shutting Down and Rebooting the System 

To shut down multiuser mode and immediately reboot the system, use the 
shutdown command with the -r option specified. For example: 

# /etc/shutdown -r +20 'doing a quick reboot' 


This will shut down and reboot the system in 20 minutes. The shutdown command 
logs the specified reason (shown within single quotion marks (”)) into the 
/usr/adm/shutdownlog file. Then, it notifies current users of the impending 
shutdown. It also creates the /etc/nologin file five minutes before the shutdown 
occurs to prevent users from logging into the system. At the specified time, the 
shutdown command shuts down multiuser mode, updates the file system 
superblocks, halts the processor, and immediately reboots multiuser mode. When 
you restart multiuser mode, the /etc/rc script automatically removes the 
/etc/nologin file to reenable user logins. 

The reboot command provides an alternative startup and shutdown capability but is 
not recommended for normal operations. 


Shutting Down a Diskless Client 

To shut down a diskless client, use the shutdown command at the client processor. 
The shutdown command works the same for diskless clients as it does for any 
processor. However, you should avoid using the shutdown -r command, because 
the default boot device may not be the Ethernet device. 
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System Startup Modes 



During normal operations and after system crashes, you may need to restart or boot 
the system. To boot any system successfully, you must know whether you want the 
system to come up in single-user or multiuser mode. 

This chapter provides information about the available startup modes. It describes 
what happens when you: 

• Boot the default device to single-user mode 

• Boot the default device to multiuser mode 

• Boot alternate devices to either single-user or multiuser mode 

• Invoke multiuser mode from single-user mode 

Chapter 3 describes the specific boot commands. 


2.1 Booting the System to Single-User Mode 

When you boot the system to single-user mode: 

• The system comes up with only the root file system mounted. All other file 
systems are unmounted and all configured terminals and networking are disabled. 
You have access only to those files and commands in the root file system, 
unless you explicitly mount other file systems. 

• The Bourne shell (sh) runs at the console under a partially active superuser 
account. Although the sh program has read the .profile file, the login 
utility has not been invoked, the superuser is not logged in, and a full 
environmental initialization for the superuser account has not occurred. 

• You must invoke the f sck program to check the integrity of the root file 
system. If the f sck program reports inconsistencies in the root file system, 
you must correct them before mounting any other file system. For a description 
of the command and its options, see f sck(8) in the ULTRIX Reference Pages. 
For examples of how and when to use the f sck program to check for and correct 
file system inconsistencies, see the Guide to System Crash Recovery for your 
processor. 

• If you need other file systems mounted, you must invoke the mount command to 
add the file systems. For a description of the command and its options, see 
mount(8) in the ULTRIX Reference Pages. 


2.2 Booting the System to Multiuser Mode 

When you boot the system to multiuser mode, the in it program invokes the 
/etc/rc startup script. The contents of this script and the /etc/rc. local script 
determine what happens, but typically: 




• The system comes up with the root (/) and any file systems specified in the 
/etc/fstab file mounted. Consequently, you have access to all files and 
commands in the root file system and other mounted file systems. 

• All terminals listed in the /etc/ttys file are enabled. Users with accounts in 
the /etc/passwd file can log in to the system, 

• The script automatically invokes f sck, which checks root and other file 
systems listed in the /etc/fstab file. 

- If f sck finds no inconsistencies, the /etc/rc script starts multiuser mode. 

- If f sck finds inconsistencies, the system stays in single-user mode, and you 
should run f sck on the file systems with reported inconsistencies. After 
correcting all reported inconsistencies, reinvoke or reboot multiuser mode. 


2.2.1 Invoking Multiuser Mode from Single-User Mode 

To invoke the multiuser mode from single-user without having to reboot, follow 
these steps: 

1. Go to the root (/) directory. 

2. Check for any active programs, daemons, or users on any mounted file system. 

3. If you find any active processes, stop them. 

4. Unmount all file systems by typing the umount command with the -a option. 
For example: 

# /etc/^lmount -a 

The umount program checks the /etc/fstab file and unmounts all file 
systems listed except root. 

5. Type the mount command with no options. The program lists any file systems 
that are still mounted. For example: 

# /etc/mount 

/dev/rzOa on / type ufs 
/dev/rzla on /tmp type ufs 

6. If any file system besides root is still mounted, type the umount command 
again. Specify the mounted file system by typing the device and partition on 
which the file system is mounted. For example, to unmount /tmp (as shown in 
the preceding listing), type: 

# /etc/umount /dev/rzla 

If the unmounting is successful, the program responds by listing the root (/) 
file system only. This indicates that all file systems except root are now 
unmounted. 

7. Check file systems. Use the f sck command to check them for inconsistencies. 
For example, type: 

# /etc/fsck 

When you type f sck without options, the program checks the file systems listed 
in the /etc/fstab file and notifies you of inconsistencies. 

For more information on the command and its options, see f sck(8) in the 
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ULTRIX Reference Pages. For a description of how and when to use the f sck 
program to correct file system inconsistencies, see the Guide to System Crash 
Recovery for your processor. 

8. Exit single-user-mode. After running f sck and correcting any reported 

inconsistencies, type CTRL/D at the console. CTRL/D ends the single-user mode 
session. 

Once single-user mode ends, the system initialization program, init, automatically 
invokes the multiuser start up script, /etc/rc. During execution, /etc/rc 
invokes /etc/rc. local. When these multiuser startup scripts successfully 
complete execution, the system is in multiuser mode. 

Note 

You cannot mount unclean file systems. If you attempt to enter 
multiuser mode with file systems that were not unmounted cleanly or 
were not checked with the f sck command, the system will not enter 
multiuser mode. 


2.2.2 Booting Multiuser Mode from Console Mode 

To boot multiuser mode directly from console mode, enter the multiuser boot 
command that is specific to your processor type. For a description of the processor- 
specific boot commands, see Chapter 3. 


2.2.3 Booting the System in Conversational Mode on VAX Processors 

To boot the system in conversational mode (available only on VAX processors), you 
enter one of the processor-specific boot commands listed in Chapter 3. In any case, 
when you boot in conversational mode, the program prompts you to enter an image 
name. For example: 

Enter image name:vmunix 


We recommend that you load the default kernel; however, you can optionally load 
another. If you take this option, use the following syntax: 

(de vice, partition) kernel_name 

The first variable, device, specifies the device where the image is located. The 
booted device is the default. The second variable, partition, specifies the 
partition on the device. Partition a of the booted device is the default. The 
kernel_name can be any kernel existing at either the default location or at the 
location you specify. 

Some device and partition syntax rules are: 

• You can specify a single number to define the device number using the default 
partition. For example: (3)vmunix 

• You can specify a single letter from a to h to define the partition using the default 
boot device. For example: (g)vmunix 

• You can specify a number and a letter for the device and partition. For example: 
(3,g)vmunix 
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• You can specify two numbers, the second of which corresponds to a letter from a 
through h for a partition, starting with 0 for a and ending with 7 for h. For 
example: (3,6)vmunix 

The first time you enter invalid input, the boot program displays the message: 

Syntax Error 

Examples of valid input syntax are: 

newvmunix - Loads newvmunix from the booted device, partition a 
{g)vmunix - Loads vmunix from the booted device, partition g 

(3)vmunix.old - Loads vmunix.old from device unit 3, partition a 

(9,g)vmunix - Loads vmunix from device unit 9, partition g 

(4,7)vmunix - Loads vmunix from device unit 4, partition h 

Note: If specified, the device unit number must be the PHYSICAL 
unit number of a device connected to the SAME CONTROLLER as the 
booted device. 


If you enter another invalid entry, the boot program simply responds: 

Syntax Error 


Note 

On MSCP-type disk drives, it is possible for the booted drive to go off 
line during a conversational boot. If you do not supply input to the 
Enter image name : prompt within several minutes, the booted 
MSCP drive goes off line and subsequent reads fail. To prevent this 
problem, enter the image name before the timeout period. 
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Processor-Specific Boot Commands 


This chapter provides guidelines for booting your processor. The boot commands 
that you use depend on your processor type and its attached hardware. The following 
sections describe the various commands with the processors grouped by section 
according to their boot commands. Follow the instructions in the section that applies 
to your processor; then continue with Chapter 4. 

3.1 Booting MicroVAX 2000, MicroVAX 3500/3600/3800/3900, 
VAXstation II, VAXstation ll/GPX, VAXstation 
2000/3200/3500, and VAXserver 100/3500/3600/3602 
Processors 

This section describes the boot commands for the following processors: 

• The MicroVAX 2000 

• The MicroVAX 3500 and MicroVAX 3600 

• The MicroVAX 3800 and MicroVAX 3900 

• The VAXstation II 

• The VAXstation II/GPX 

• The VAXstation 2000 

• The VAXstation 3200 and VAXstation 3500 

• The VAXserver 100 

• The VAXserver 3500, VAXserver 3600, and VAXserver 3602 

3.1.1 Booting from the Console 

Follow these steps to boot your processor from the console: 

1. Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 

2. Boot the default system disk by typing: 

>»b 

The console program attempts to boot the first device it finds that contains a valid 
boot block. The program first searches diskette devices, other removable disks 
(such as the RA60), for example, and the Winchester devices. Winchester 
devices are searched from lowest to highest unit number. Removable disks have a 
higher priority than Winchester devices, regardless of unit number. 




3. Decide which startup mode you want, and then type the corresponding entry at 
the prompt. For example: 


Mode 

Single-user 

Multiuser 

Conversational 
(single-user mode) 

Conversational 
(multiuser mode) 


Prompt and Entry 

»> b/2 duan 
»> b duan 
»> b/3 duan 

»> b/1 duan 


The variable n specifies the device number of the system disk drive. For 
example, to boot vmunix (the kernel image) to single-user mode from RD53 
drive 1 on a MicroVAX II, type: 

»>b/2 dual 

See Chapter 2 for additional information on startup modes. 


3.1.2 Booting from a TK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from a TK50 tape. After installing the TK50 boot tape, 
type: 

>>>b muaO 


In response to this entry, the console subsystem boots the TK50 boot tape. 

3.1.3 Booting from the Network 

You must boot from the network to perform any of the following operations: 

• Booting a diskless system 

• Initiating an installation from a remote server 

• Booting a standalone kernel from a remote server, in order to perform system 
management tasks 

The boot command that you choose depends upon the type of processor you have. If 
you are booting the MicroVAX II, the VAXstation II, the VAXstation II/GPX, the 
VAXstation 3200, the VAXstation 3500, a MicroVAX 3000 series processor, a 
VAXserver 100, or a VAXserver 3000 series processor, type: 

»>b xqaO 


• If you are booting the MicroVAX 2000 or the VAXstation 2000 from the 
network, type: 

»>b esaO 


In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 
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3.2 Booting MicroVAX 3300 and MicroVAX 3400 Processors 

The following sections describe how to boot these processors from the console or the 
network. 


3.2.1 Booting from the Console 

Follow these steps to boot your processor from the console: 

1. Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 

2. Identify which device (if any) was set as the default by typing: 

»>show boot 

The console program responds with the device name. For example: 

»>show boot 

DIAO 


3. Boot the default system disk by typing: 

»>b 


The console program boots the default device and displays the device name. For 
example: 

»>b 

(BOOT/R5:0 DIAO) 


4. Decide which startup mode you want, and then type the corresponding entry at 
the prompt. For example: 


Mode 

Single-user 

Multiuser 

Conversational 
(single-user mode) 

Conversational 
(multiuser mode) 


Prompt and Entry 

»> b/2 dian 
»> b dian 
»> b/3 dian 

»> b/1 dian 


The variable n specifies the device number of the system disk drive. For 
example, to boot vmunix (the kernel image) to single-user mode from drive 1 on 
a MicroVAX 3400, type: 

»>b/2 dial 

See Chapter 2 for additional information on startup modes. 


3.2.2 Booting from the Network 

You must boot from the network to perform any of the following operations: 
• Booting a diskless system 
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• Initiating an installation from a remote server 

• Booting a standalone kernel from a remote server, in order to perform system 
management tasks 

To boot the system from the network, use the following command: 

>»b esaO 


In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 


3.3 Booting VAXstation 3100, Micro VAX 3100, and VAXserver 
3100 Processors 

Your choice of a boot command for a VAXstation 3100, Micro VAX 3100, or 
VAXserver 3100 depends on your hardware configuration. The following sections 
describe the various boot commands. 

3.3.1 Booting from the Console 

Follow these steps to boot your processor from the console: 

1. Press the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 

2. Find out which device (if any) was set as the default by typing: 

»>show boot 

- If a default device was set, the console program responds with the name of 
the default device. For example: 

»>show boot 

DKA300 

- If no default device was set, the console program responds as follows: 
»>show boot 


3. Get a boot device listing by typing: 

»>show device 

The console program displays a device listing similar to this: 


VMS/VMB 

ULTRIX 

ADDR 

DEVTYP 

NUMBYTES 

RM/FX WP 

DEVNAME 

ESAO 

SEO 

08-00-2B- 

07-05-09 




DKA300 

RZ23 

A/3/0/00 

DISK 

06407E00 

FX 

RZ23 

MKA500 

TZ5 

A/5/0/00 

TAPE 


RM 


HostID 


A/6 

INITR 




DKBIOO 

RZ9 

B/1/0/00 

DISK 

1383B200 

FX 

RZ55 

DKB200 

RZIO 

B/2/0/00 

RDDISK 

06407E00 

RM 

RZ23 

DKB300 

RZll 

B/3/0/00 

RDDISK 

06407E00 

RM 

RZ23 

DKB400 

RZ12 

B/4/0/00 

DISK 

0C3B1600 

RM 

RRD40 

MKB500 

TZ13 

B/5/0/00 

TAPE 


RM 


HostID 


B/6 

INITR 
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In the preceding display: 

- Column 1 lists the boot command name associated with a particular device 
configured at a specific address. 

- Column 2 lists the ULTRIX device mnemonic and number associated with a 
particular device type. 

- Column 3 lists the address of the specific device. The first character specifies 
the SCSI controller identification (either A or B). The second character 
specifies the SCSI bus identification number. The remaining characters are 
always zeroes. 

- Column 4 lists the device types. 

- Column 5 lists internal addressing information needed by the system. 

- Column 6 lists mnemonics that indicate whether the device is fixed or 
removable. 

- Column 7 lists the physical device name. 

4. Boot the default system device by typing: 

>»b 

The console program boots the default device. However, if no default device was 

set previously, the console defaults to a network boot. 

5. Boot a specific device using the following format: 
bboot device name 

For example, assume you wanted to boot an RZ23 fixed disk at SCSI controller 

A, SCSI bus 3. To boot this device, type: 

»>b DKA300 


Note 

The console program is not case-sensitive when accepting boot 
commands for the VAXstation 3100 processor. Consequently, you 
can use either uppercase or lowercase letters when typing the boot 
command name. 


6. Decide which startup mode you want and then type the corresponding entry at the 
prompt. 

- If you are booting a disk device at SCSI controller A, use the following list to 
determine the correct entry: 


Mode 

Single-user 
Multiuser 
Conversational 
(single-user mode) 

Conversational 
(multiuser mode) 


Prompt and Entry 

»> b/2 dkan 
»> b dkan 
»> b/3 dkan 

»> b/1 dkan 


The variable n specifies the SCSI bus identification number of the system 
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disk drive. For example, to boot vmunix (the kernel image) to single-user 
mode from the system disk at SCSI bus ID 3, type: 

»>b/2 dkaSOO 


To boot vmunix (the kernel image) to multiuser mode from the system disk 
at SCSI bus ID 2, type: 

>>>b dka200 


- If you are booting a disk device at SCSI controller B, use the following list to 
determine the correct entry: 


Mode 

Single-user 

Multiuser 

Conversational 
(single-user mode) 

Conversational 
(multiuser mode) 


Prompt and Entry 

»> b/2 dkbn 
»> b dkbn 
»> b/3 dkbn 

>» b/1 dkbn 


The variable n specifies the SCSI bus identification number of the system 
disk drive. For example, to boot vmunix (the kernel image) to single-user 
mode from the system disk at SCSI bus ID 3, type: 

»>b/2 dkb300 

To boot vmunix (the kernel image) to multiuser mode from SCSI bus ID 2, 
type: 

»>b dkb200 

See Chapter 2 for additional information on startup modes. 


3.3.2 Booting from a TZ30 or TZK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from tape. After installing the boot tape, use one of the 
following boot commands: 

• If you are booting from tape at SCSI controller A, use the following format: 

b mkan 

The variable n specifies the SCSI bus identification number of the system tape. 
For example, to boot from tape at SCSI controller A, SCSI bus ID 3, type: 

»>b mkaSOO 

In response to this entry, the console subsystem boots the boot tape. 

• If you are booting from tape at SCSI controller B, use this syntax: 

b mkb/7 

The variable n specifies the SCSI bus identification number of the system tape. 
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For example, to boot from tape at SCSI controller B, SCSI bus ID 3, type: 
»>b mkb300 


3.3.3 Booting from the Network 

You must boot from the network to perfom any of the following operations: 

• Booting a diskless system 

• Initiating an installation from a remote server 

• Booting a standalone kernel from a remote server, in order to perform system 
management tasks 

To boot the system from the network, use the following command: 

»>b easO 

In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 

3.4 Booting a VAXstation 3520 or a VAXstation 3540 

Your choice of a boot command for a VAXstation 3520 or 3540 depends on your 
hardware configuration. The following sections describe the various boot commands. 

3.4.1 Booting from the Console 

Follow these steps to boot your processor from the console: 

1. Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 

2. Find out which device (if any) was set as the default by typing: 

>>>show boot 

If a default device was set, the console program responds with the name of the 
default device. For example: 

»>show boot 

DKAIOO 

If no default device was set, the console program responds as follows: 

»>show boot 

3. Get a boot device listing by typing: 

»>show scsi 
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The console program displays a device listing similar to this: 


ADDR 

VMB 

DEVTYP 

DEVNAM 

NUMBYTS 

REV 

CHAR 

5.0.0 

DKAO 

DISK 

RZ55 

332 MB 

0700 


5.1.0 

DKAIOO 

DISK 

RZ55 

332 MB 

0700 


5.4.0 

DKA400 

DISK 

RZ55 

332 MB 

0700 


5.6.0 

5.7 

DKA600 

RODISK 

HOST 

RRD4 0 

SII-A 

599 MB 

250D 

RM,WP 


In the preceding display: 

- Column 1 lists internal addressing needed by the system 

- Column 2 lists the VMS device mnemonic and number associated with a 
particular device type. 

- Column 3 lists the device type. 

- Column 4 lists the device name. 

- Column 5 lists the number of bytes on the media. 

- Column 6 lists the device microcode. 

4. Boot the default system device by typing: 

»>b 

The console program boots the default device. However, if a default device was 
not set, the boot will fail with the following error message: 

740NOSUCHDEV 

5. Boot a specific device by typing: 

»> b boot_device_name 


For example, to boot an RZ55 fixed disk at SCSI bus ID 1, type: 
»>b DKAIOO 


Note 

The console program is not case sensitive when accepting boot 
commands for the VAXstation 3520 processor. Consequently, you 
can use either uppercase or lowercase letters when typing the boot 
command name. 


6. Decide which startup mode you want and then type the corresponding entry at the 
prompt. Use the following list to determine the correct entry: 


Mode 

Single-user 

Multiuser 

Conversational 
(single-user mode) 
Conversational 
(multiuser mode) 


Prompt and Entry 

>>> b/2 dkan 
>>> b dkan 
>>> b/3 dkan 

>>> b/1 dkan 
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The variable n specifies the SCSI bus identification number of the system disk 
drive. For example, to boot vmunix (the kernel image) to single-user mode 
from the system disk at SCSI bus ID 3, type; 

»>b/2 dka300 

To boot vmunix (the kernel image) to multiuser mode from the system disk at 
SCSI bus ID 2, type: 

»>b dka200 

See Chapter 2 for additional information on startup modes. 


3.4.2 Booting a TK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from a TK50 tape. After installing the TK50 boot tape, 
type: 

>>>b muaO 

In response to this entry, the console susbystem boots the TK50 boot tape. 

3.5 Booting a VAX-11 /750 

Your choice of a boot command for a VAX-11/750 depends on your hardware 
configuration. The following sections describe the boot commands for both local 
disks and remote disks connected to an HSC. 

3.5.1 Booting a Local Disk 

The following list describes the boot commands for local disks: 

• To boot the default system disk to multiuser mode, type; 

»>b 

• To boot the system disk to single-user mode, type: 

»>b/3 

The console subsystem reads the askboo. cmd file, boots the default system 
disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate disk, use one of the commands listed in the following table. 
Be aware that RP07 drives are not supported as boot devices. 

Conversational Conversational 

Drive Type Single-user Multiuser Single-User Multiuser 

RAj:;c Disk b/2 duan b duan b duan b/1 duan 

RP05/06 and b/2 dban b dban b/3 dban b/1 dban 

RM03/05/80 Disks 


The variable xx is the model number of the system disk drive and the variable 
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n represents the unit number of the system disk drive. For example, to boot 
multiuser mode from an RM05 system disk, unit number one, type: 

>>>b dbal 

See Chapter 2 for information on each of the startup modes. 


3.5.2 Booting an HSC Disk 

On a VAX-11/750 processor, the system must load Cl microcode contained on the 
console cassette. Therefore, you must ensure that a valid console cassette is in the 
TU58 drive and that your selector switch is at the cassette setting before attempting 
to boot an HSC disk. 

The console cassette contains the boot command procedure files that enable the 
system to boot the default and alternate disks. The boot command procedure files 
are: 

• askboo. cmd, which boots the default disk to single-user mode 

• defboo. cmd, which boots the default disk to multiuser mode 

• cira . cmd, which boots an alternate disk to single-user or multiuser mode 

When the Cl microcode is loaded, the software can boot either the default or an 
alternate HSC disk to a particular startup mode. The following list describes the boot 
commands: 

• To boot the default HSC system disk to multiuser mode, type: 

>>>b 

The console subsystem reads the defboo. cmd file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default HSC system disk to single-user mode, use this format: 

»>b/800 ddaO 
BOOTS8> @askboo.cmd 


The console subsystem reads the askboo. cmd file, boots the default system 
device, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk, use this format: 

»> b/800 ddaO 
BOOT58> D/G 2 HSC# 

BOOT58> D/G 3 unit# 

BOOT58> @cira.cmd 

The HSC# is the remote Cl port number assigned to the specific HSC controller. 
The unit# variable is the device number of the system disk drive. The 
@cira . cmd string invokes the HSC boot command file. 
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Note 


Both the HSC number and the unit number must be expressed in 
hexadecimal. 

The console subsystem reads the cira. cmd file, boots the alternate system 
device, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.6 Booting a VAX-11 /780 or a VAX-11 /785 

Your choice of a boot command for a VAX-11/780 or a VAX-11/785 depends on 
your hardware configuration. The following sections describe the boot commands for 
both local disks and remote disks connected to an HSC. 

Note 

The descriptions in this section assume that the front-end console storage 
device has been updated to reflect the proper default boot device. Refer 
to Section 3.10 for information on how to do this. 

3.6.1 Booting a Local Disk 

The VAX-11/780 and VAX-11/785 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate disks are: 

• defboo. cmd, which boots the default disk to multiuser mode 

• askboo. cmd, which boots the default disk to single mode 

• mbahp. cmd, which boots an alternate MASSBUS disk to single-user mode 

• ubara. cmd, which boots an alternate UNIBUS disk connected to a UDA-50 
controller to single-user mode 

The following list describes the boot commands: 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem reads the defboo. cmd file, boots the default system 
disk, and brings the system up in multiuser mode. 

• To boot the default system disk to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
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disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel, 

• To boot an alternate MASSBUS disk to single-user mode, use this format: 

»> d r1 TR^ 

»> d r3 uniW 
»> @mbahp.cmd 

The TiR# variable is the TR level number of the MASSBUS adapter. The unit# 
variable is the device number of the system disk drive. The @mbahp. cmd string 
invokes the MASSBUS adapter boot command file. 

Note 

Both the TR level number and the unit number must be expressed in 
hexadecimal. 

The console subsystem reads the mbahp. cmd file, boots the alternate system 
disk, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate UNIBUS disk connected to a UDA-50 controller to single- 
user mode, use this format: 

»> d r1 TR# 

»> d r3 unit# 

»> @ubara.cmd 

The TR# variable is the TR level number of the UNIBUS adapter. The unit# 
variable is the device number of the system disk drive. The @ubara. cmd string 
invokes the UNIBUS adapter boot command file. 

Note 

Both the TR level number and the unit number must be expressed in 
hexadecimal. 

The console subsystem reads the ubara. cmd File, boots the alternate system 
disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 


3.6.2 Booting an HSC Disk 

The VAX-11/780 and VAX-11/785 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate HSC disks are: 
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• defboo . cmd, which boots the default disk to multiuser mode 

• askboo. cmd, which boots the default disk to single-user mode 

• cira. cmd, which boots an alternate disk to single-user mode 

The following list describes the boot commands: 

• To boot the default system disk to multiuser mode, type: 

>»b 

The console subsystem reads the defboo. cmd file, boots the default system 
disk, and brings the system up in multiuser mode. 

• To boot the default system disk to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk to single-user mode, use this format: 

»> d r2 HSC# 

»> d r3 tyn/f# 

>» @cira.cmd 

The HSC# variable is the remote Cl port number assigned to the specific HSC 
controller. The unit# variable is the device number of the system disk drive. 
The @cira. cmd string invokes the HSC boot command file. 

Note 

Both the HSC number and the unit number must be expressed in 
hexadecimal. 

The console subsystem reads the cira. cmd file, boots the alternate system disk, 
and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

3.7 Booting a VAX 6210/6220/6230/6240, VAX 

6310/6320/6330/6340/6350/6360, or a VAX 6000-series 

This section describes the boot commands for the following processors: 

• VAX 6220/6230/6240 

• VAX 6310/6320/6330/6340/6350/6360 

• VAX 6000-410/420/430/440/450/460 

Your choice of a boot command for these processors depends on your hardware 
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configuration. The following sections describe the boot commands for both local 
disks and remote disks connected to an HSC. 


3.7.1 Booting a Local Disk 

The following list describes the boot commands for local disks: 

• To boot the default system disk to multiuser mode, type: 

»>b 

• To boot the system disk to single-user mode, type: 

>>>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
disk, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate disk, type: 

»> b/xmi:BM#/bi:B/#/r5:1000b duun/f# 

The BIA# variable represents the number (0,1,2, or 3) of the BI adapter 
connected to the xmi. The BI# variable represents the BI node number of the 
xmi adapter. The unit# variable represents the device number of the system 
disk drive. 


Note 

The BIA number, the BI number, and the unit number must be 
expressed in hexadecimal. 

The console subsystem boots the alternate system device and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.7.2 Booting an HSC Disk 

On a VAX 6210 or a VAX 6220 processor, the system must load Cl microcode 
contained on the TK50 cartridge. Therefore, you must ensure that a valid cartridge is 
in the TK50 drive before attempting to boot an HSC disk. See your Field Services 
representative for details on the correct procedure. 

The following list describes the boot commands: 

• To boot the default HSC system disk to multiuser mode, type: 

>»b 

The console subsystem reads the def boo. cmd file, boots the default system 
device, and brings the system up in multiuser mode. 
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• To boot the default HSC system disk to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
device, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk, type: 

»> b /xmi:SM#/bl:S/#/node:HSC#/r5:1000b duun/Y# 


The BIA# variable represents the number (0, 1, 2, or 3) of the BI adapter 
connected to the xmi. The BI# variable represents the BI node number of the 
xmi adapter. The HSC# represents the remote Cl port number assigned to the 
specific HSC controller. The du uni t#variable represents the device number of 
the system disk drive. 

Note 

The BIA number, the BI number, the HSC number, and the unit 
number must be expressed in hexadecimal. 

The console subsystem boots the alternate system device, and displays the 
prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.8 Booting a VAX 8200, VAX 8250, VAX 8300 or a VAX 8350 

On a VAX 8200, 8250, 8300, or 8350, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 

Note 

The descriptions in this section assume that the EEPROMs have been 
reprogrammed to reflect the proper default boot device. Refer to Section 
3.11 for information on how to do this. 


3.8.1 Booting a Local Disk 

On any of these processors, the default boot command boots the default device 
described in the EEPROM of the processor. Programming the EEPROM is described 
in the VAX Owner’s Manual. 
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The following list describes the boot commands that you use to boot local disks: 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem boots the default system disk and brings the system up in 
multiuser mode. 

• To boot the default system disk to single-user mode, type: 

»>b/r5:3 

The console subsystem boots the default system disk, brings the system up in 
single-user mode, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate disk, use one of the commands listed in the following table. 


Mode 


Prompt and Entry 


Single-user 
Multiuser 
Conversational 
(In single-user mode) 

Conversational 
(In multiuser mode) 


>>> b/r5:2 duSIln 
»> b duBI#/] 

>>> b/r5:3 duBI#n 

>>> b/r5:l duBIln 


The BJ# variable represents the BI node number and the n variable represents the 
unit number of the desired boot device. For example, to boot in conversational 
mode (assuming a BI node number of 4 and a unit number of 0), type: 

»>b/r5:3 du40 

The system comes up in conversational mode, signified by the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.8.2 Booting an HSC Disk 

On any of these processors, the default boot command boots the default device 
described in the EEPROM of the processor. Programming the EEPROM is described 
in the VAX Owner’s Manual. 

The following list describes the boot commands that you use to boot the default and 
alternate disks: 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem boots the default system disk and brings the system up in 
multiuser mode. 
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• To boot the default system disk to single-user mode, use this format: 

»>b/r5:800 

BOOTS8> Gaskboo.cmd 

The console subsystem reads the askboo. cmd file, boots the default system 
disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk, use this format: 

>» b/r5:800 csa1 
BOOT58> D/G 1 B/# 

BOOT58> D/G 2 HSC# 

BOOT58> D/G 3 unit# 

BOOT58> @clra.cmd 

The BI# variable represents the BI node number of the Cl adapter. The HSC# 
variable represents the remote Cl port number assigned to the specific HSC 
controller. The unit# variable represents the device number of the system disk 
drive. The @cira . cmd string invokes the HSC boot command file. 

Note 

The BI number, the HSC number, and the unit number must be 
expressed in hexadecimal. 

The console subsystem reads the cira. cmd file, boots the alternate system 
device, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.9 Booting a VAX 8500, VAX 8530, VAX 8550, VAX 8700, VAX 
8800, or a VAX 8810 

On a VAX 8500, 8530, 8550, 8700, 8800, or 8810, the boot command you use 
depends on your hardware configuration. The following sections describe the boot 
commands for both local disks and remote disks connected to an HSC. 

Note 

The descriptions in this section assume that the front-end console storage 
device has been updated to reflect the proper default boot device. Refer 
to Section 3.11 for information on how to do this. 


3.9.1 Booting a Local Disk 

All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 
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• defboo. com, which boots the default system disk to multiuser mode 

• askboo. com, which boots the default system disk to single-user mode 

• bdara. com, which boots an alternate disk to single-user mode if the BI adapter 
is a KDB50 

The following list describes the boot procedures for the various disks and modes: 

• To boot the default system device to multiuser mode, type: 

»>b 

The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default system device to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo.com file, boots the default system 
disk, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate disk (where the BI adapter is a KDB50) to single-user mode, 
use the format: 

»> d r1 BlA#Bl# 

»> d r3 unit# 

»> @bdara.com 

The BIA# variable represents the number of the BI adapter (0, 1, 2, or 3) 
connected to the KDB50. The BI# variable represents the BI node number of the 
KDB50 adapter. The unit# variable is the device number of the system disk 
drive. The @bdara. com string invokes the KDB50 boot command file. 

Note 

The BI adapter number, the BI node number, and the unit number 
must be expressed in hexadecimal. 

The console subsystem reads the bdara. com file, boots the alternate system 
disk, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.9.2 Booting an HSC Disk 

All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 

• defboo. com, which boots the default system disk to multiuser mode 
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• askboo. com, which boots the default system disk to single-user mode 

• bcira. com, which boots an alternate disk to single-user mode if the BI adapter 
is a BCA 

The following list describes the boot commands for the various disks and modes: 

• To boot the default system disk to multiuser mode, type: 

>»b 

The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default system disk to conversational mode, type: 

>»b ask 

The console subsystem reads the askboo. com file, boots the default system 
device, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk to single-user mode when the Cl adapter is a 
BCA, use the format: 

>» d r1 BlAmi# 

»> d r2 HSC# 

»> d r3 unit# 

»> @bcira.com 


The BIA# variable represents the number (0, 1, 2, or 3) of the BI adapter 
connected to the Cl adapter. The BI# variable represents the BI node number of 
the Cl adapter. The BSC# variable represents the remote Cl port number 
assigned to the specific HSC controller. The unit# variable is the device 
number of the system disk drive. The @bcira.com string invokes the HSC 
boot command procedure file. 


Note 

The BI adapter number, the BI node number, the HSC number, and 
the unit number must be expressed in hexadecimal. 

The console subsystem reads the bcira. com file, boots the alternate HSC disk, 
and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 


3.10 Booting a VAX 8820/8830/8840 

On a VAX 8820/8830/8840 processor, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 
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3.10.1 Booting a Local Disk 

All of these processors have ffont-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 

• defboo. cmd, which boots the default system disk to multiuser mode 

• askboo. cmd, which boots the default system disk to single-user mode 

• bdara. cmd, which boots an alternate disk to single-user mode if the BI adapter 
is a KDB50 

The following list describes the boot procedures for the various disks and modes: 

• To boot the default system device to multiuser mode, type: 

»>b 

The console subsystem reads the defboo. cmd file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default system device to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
disk, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate disk (where the BI adapter is a KDB50) to single-user mode, 
use the format: 

»> d r1 BlAmi# 

»> d r3 unM 
»> <§)bdara.cmd 

The BIA# variable represents the number of the BI adapter (0, 1, 2, 3, 4, or 5) 
connected to the KDB50. The SI# variable represents the BI node number of the 
KDB50 adapter. The unit# variable is the device number of the system disk 
drive. The @bdara. cmd string invokes the KDB50 boot command file. 

Note 

The BI adapter number, the BI node number, and the unit number 
must be expressed in hexadecimal. 

The console subsystem reads the bdara. cmd file, boots the alternate system 
disk, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 
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3.10.2 Booting an HSC Disk 

All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 

• defboo. cmd, which boots the default system disk to multiuser mode 

• askboo. cmd, which boots the default system disk to single-user mode 

• bear a. cmd, which boots an alternate disk to single-user mode if the BI adapter 
is a BCA 

The following list describes the boot commands for the various disks and modes: 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem reads the defboo. cmd file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default system disk to conversational mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
device, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk to single-user mode when the Cl adapter is a 
BCA, use the format: 

»> d r1 BIA#BI# 

»> d r2 HSC# 

»> d r3 unit# 

»> @bcara.cmd 

The BIA# variable represents the number (0, 1, 2, 3, 4, or 5) of the BI adapter 
connected to the Cl adapter. The BI # variable represents the BI node number of 
the Cl adapter. The HSCi variable represents the remote Cl port number 
assigned to the specific HSC controller. The unit# variable is the device 
number of the system disk drive. The @bcara. cmd string invokes the HSC 
boot command procedure file. 


Note 

The BI adapter number, the BI node number, the HSC number, and 
the unit number must be expressed in hexadecimal. 

The console subsystem reads the bcara. cmd file, boots the alternate HSC disk, 
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and displays the prompt: 
Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.11 Booting a VAX 8600 or a VAX 8650 

On a VAX 8600 or VAX 8650, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 

3.11.1 Booting a Local Disk 

Both of these processors have front-end console storage devices that contain boot 
command procedure files. These files enable you to boot the default and alternate 
disks. They are: 

• defboo. com, which boots the default system device to multiuser mode 

• askboo. com, which boots the default system device to single-user mode 

• mbahp. com, which boots an alternate MASSBUS disk to single-user mode 

• ubara. com, which boots an alternate UNIBUS disk connected to a UDA-50 
controller to single-user mode 

The following list describes the boot procedures for the various disks and modes: 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 

• To boot the default system device to single-user mode, type: 

»>b ask 

The console subsystem reads the askboo. com file, boots the default system 
device, and displays the prompt: 

Enter image name: 

In response to this prompt, enter the name of the kernel. 

• To boot an alternate MASSBUS disk to single-user mode, use this format: 

»> d ri SBmrm 
»> d r3 unit# 

»> @mbahp.com 

The SB I# variable represents the Synchronous Backplane Interconnect I/O 
adapter number (either 0 or 1). The TR# variable represents the TR level number 
of the MASSBUS adapter. The unit# variable is the device number of the 
system disk drive. The @mbahp. com string invokes the MASSBUS boot 
command procedure file. 
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Note 


The SBI number, TR level number, and the unit number must be 
expressed in hexadecimal. 

The console subsystem reads the mbahp. com file, boots the alternate disk to 
single-user mode, and displays this prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate UNIBUS disk connected to a UDA-50 controller to single- 
user mode, use this format: 

»> d r1 SBI#TR# 

»> d r3 unit# 

»> @ubara.com 

The SBI# variable represents the SBI I/O adapter number (either 0 or 1). The 
TR# variable represents the TR level number of UNIBUS adapter. The unit# 
variable represents the device number of the system disk drive. The 
@ubara. com string invokes the UNIBUS boot command procedure file. 

Note 

The SBI number, the TR level number, and the unit number must be 
expressed in hexadecimal. 

The console subsystem reads the ubara. com file, boots the alternate disk to 
single-user mode, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.11.2 Booting an HSC Disk 

The VAX 8600 and VAX 8650 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate HSC disks are: 

• defboo. com which boots the default system disk to multiuser mode 

• askboo.com which boots the default system disk to single-user mode 

• cira.com which boots an alternate system disk to single-user mode 

The following list describes the boot commands for the various disks and modes. 

• To boot the default system disk to multiuser mode, type: 

»>b 

The console subsystem reads the defboo. cmd file, boots the default system 
device, and brings the system up in multiuser mode. 
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• To boot the default system device to conversational mode, type: 

»>b ask 

The console subsystem reads the askboo. cmd file, boots the default system 
device, and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 

• To boot an alternate HSC disk to single-user mode, use this format: 

>» d r1 SBI#TR§ 

»> d r2 HSC# 

»> d r3 unit# 

»> @cira.com 

The SB I# variable represents the Synchronous Backplane Interconnect I/O 
adapter number (either 0 or 1). The TR# variable represents the TR level number 
of the Cl adapter. The HSC# variable represents the remote Cl port number 
assigned to the specific HSC controller. The unit# variable represents the 
device number of the system disk drive. The @cira. com string invokes the 
HSC boot command procedure file. 


Note 

The SBI number, the TR number, the HSC number, and the unit 
number must be expressed in hexadecimal. 

The console subsystem reads the cira. com file, boots the alternate HSC disk, 
and displays the prompt: 

Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.12 Building and Updating Boot Command Files 

This section describes how you can build or update processor-specific boot command 
files. You have to build or update the processor-specific boot command files when 
you want to change the boot default system disk permanently. Some of the processors 
require you to build new boot command files, while others require you to update 
existing boot command files: 

• The processors that require you to build new command files are the VAX-11/750, 
VAX 11/780, VAX 11/785, VAX 8600, and VAX 8650 processors. 

• The processors that require you to update the existing boot command files are the 
VAX 6210, VAX 6220, VAX 8200, VAX 8500, VAX 8540, VAX 8550, VAX 
8700, VAX 8800, and VAX 8810 processors. 

The following sections contain the procedures for either building or updating a 
processor-specific, bootable console medium. The medium contains the necessary 
hardware support files and the command procedure files for booting the operating 
system. 
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Note 


In some cases, the procedures require you to use the file editor, EDT. 
While some EDT commands are provided, you should have the 
appropriate Console Operator’s Guide available for further EDT 
reference information. 


3.12.1 Building a VAX-11 /750 Console Cassette 

In general, you do not need to build a new console cassette for a VAX-11/750. 
However, if your hardware supports an HSC configuration, you must build a new 
cassette to enable the HSC remote boot commands. 

To build the cassette, follow these steps: 

1. Invoke the mkconsole program by typing: 

# etc/mkconsole 

The program assumes that /vmunix is the running kernel. When you run the 
program, mk console prompts you to remove any cassette from the drive and 
insert a blank cassette. 

2. Replace the original console cassette with a blank cassette, and press the 
RETURN key. The program responds with a brief message to explain its 
activity. At completion, the system prompt appears. 

After building the new cassette, your system is able to boot a remote HSC device. 


3.12.2 Building a VAX-11 /780 or a VAX-11 /785 Console Diskette 

The procedure in this section describes how to build a boot command file that boots 
the current running system disk. The procedure assumes that the /usr file system is 
mounted. 

During the creation of a bootable diskette, you may have to edit the boot command 
file to set either the memory starting addresses or to set interleaving if you have 
multiple memory controllers. Therefore, a brief description of the contents of the 
boot command file is also included in this section. 

For either the VAX-11/780 or VAX-11/785 processors, there are several boot 
command files that you can use to start your system. The format of these command 
files is the same. Each one contains setup and initialization commands, several 
DEPOSIT statements, and several startup statements. 

The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program VMB. EXE, to 
determine which device is to be booted. All DEPOSIT statements require 
hexadecimal values. 

The GPRs and their meanings are: 

• RO - Boot device type code 

• R1 - Processor-specific adapter information 

• R2 - Controller number 

• R3 - Unit number of the boot device 
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• R4 - Logical boot block number 

• R5 - Boot control flags 

Appendix B contains a complete listing of the values for each of these registers. 

Example 3-1 shows a sample boot command file (defboo. cmd) for a VAX-11/780 
processor. 


Example 3-1: Sample VAX-11/780 Boot Command File 


RA BOOT COMMAND FILE - UNIBUS RA DISK 


THE UNIBUS ADAPTER TR LEVEL MUST BE DEPOSITED IN R1 AND THE 

UNIT NUMBER MUST BE DEPOSITED IN R3 BEFORE EXECUTING THIS PROCEDURE 


HALT 

UNJAM 

INIT 


DEPOSIT/I 

11 20003800 

DEPOSIT 

RO 

11 

DEPOSIT 

R1 

3 

DEPOSIT 

R2 

3F468 

DEPOSIT 

R3 

0 

DEPOSIT 

R4 

0 

DEPOSIT 

R5 

10008 

DEPOSIT 

FP 

0 


START 20003000 
WAIT DONE 


HALT PROCESSOR 

UNJAM SBI 

INIT PROCESSOR 

SET UP SCBB 

UDA-MSCP DISK 

TR LEVEL OF UNIBUS 

CSR ADDRESS OFFSET = 3F468 

PLUG # OF SYSTEM DISK 

BOOT BLOCK LBN (UNUSED) 

BOOT ULTRIX TO MULTI USER 
SET NO MACHINE CHECK EXPECTED 
START ROM PROGRAM 
WAIT FOR COMPLETION 


EXAMINE SP 

LOAD VMB.EXE/START:@ 

START 0 


SHOW ADDRESS OF WORKING MEMORY 0x200 
LOAD PRIMARY BOOTSTRAP 
AND START IT 


There are several steps that you must follow to build an ULTRIX console diskette for 
the VAX-11/780 or VAX-11/785 processors: 

1. Insert the RXOl console diskette into the diskette drive. This is the diskette that 
you use to initialize your hardware when you power up the system. 

2. Run the mkcons ole command: 

# etc/mkconsole 

This command assumes that /vmunix is the running kernel. When you run the 
mkconsole command, it displays a number of prompts and messages. 

During this step, the mkconsole command instructs you to insert a blank 
diskette. Replace the RXOl console diskette in the drive with a blank diskette. 
When the new diskette is created, you can leave it in the diskette drive. 

3. If you have multiple memory controllers, you may have to edit the 

defboo. cmd, askboo. cmd, and restar. cmd command files to change the 
memory starting addresses or interleaving settings. Check with your field service 
representative to get the correct starting addresses or settings for your system. 

Before you can edit any of these files, you must extract them from the console 
diskette by using the arf f command. After you modify the command files, 
replace them on the console diskette using the arf f command before 
proceeding. 
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The b or b ask boot command options are available, as described in Section 3.5. 


3.12.3 Updating VAX 6210/6220/6230/6240, VAX 

6310/6320/6330/6340/6350/6360, or VAX 6000-series Boot Command 
Fiies 

These processors store the boot data in Electrically Erasable Programmable Read- 
Only Memory (EEPROM). The EEPROMs contain such data as the default boot 
device information. 


Note 

You can use the /etc/mkconsole program to get precise instructions 
for updating your console boot defaults. 

To make changes to the EEPROM data, follow these steps: 

1. Shutdown your system and halt the processor. 

2. Reset the system by typing the initialize command at the console prompt. 
For example, type: 

»>initialize 

3. Set the processor’s selector switch to the “Update” position. 

4. Enter the following commands to set the default multiuser boot command for a 
local disk and an HSC disk. 

- For a local disk, use this syntax: 

set boot default /xmi:S/yA#/bi:6/#/r5:10008 6uunit# 

For example, type: 

>>>set boot default /xmi:e /bi:4 /r5:10008 duO 

- For an HSC disk, use this syntax: 

set boot default /xmi:SM#/bi:i5/#/node:/-/SC#/r5:10008 duun/Y# 

For example, type: 

»>set boot default /xmi:e /bi:4 /node:l /r5:10008 duO 

The variable numbers must be expressed in hexadecimal notation. 

5. Enter the following commands to set the default single-user boot command for a 
local disk and an HSC disk. This allows a conversational boot to single user, 
using the b ask command. 

- For a local disk, use this syntax: 

set boot ask /xmi:6M#/bl:e/#/r5:1000b duun/Y# 
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For example, type: 

»>set boot ask /xmi:e /bi:4 /r5:1000b duO 

- For an HSC disk, use this syntax: 

set boot ask/xmi:BM#/bi:6/#/node:HSC#/r5:1000b duunit# 

For example, type: 

»>set boot ask /xml:a /bi:4 /node:l /r5:1000b duO 

The variable numbers must be expressed in hexadecimal notation. 

6. Reset the selector switch from the “Update” setting to its original setting. 

7. If you are booting a Cl disk, make sure that the TK50 console tape is in the drive. 

8. Boot the system to multiuser or single user mode: 

- Boot to multiuser mode by typing: 

»>b 

- Boot to single-user mode by typing: 

»>b ask 


3.12.4 Changing the VAX 8200, VAX 8250, VAX 8300, and the VAX 8350 
Boot Data 

Each of these processors stores its boot data on Electrically Erasable Programmable 
Read-Only Memory (EEPROM). The EEPROMs contain such data as the default 
console baud rate and the default boot device. To make changes to this data, you 
must run the EEPROM utility, which is stored on the diskette labeled: UTIL PROG 
FLP. 

The EEPROM utility runs under the VAX Diagnostic Supervisor (VDS) software. 
Therefore, to run the EEPROM utility, you must boot the VDS software. The 
procedures for running the VDS software, as well as a complete description of the 
EEPROM utility’s functionality, is described in your processor-specific Owner’s 
Manual. 

It may be necessary to update the EEPROMs to boot the diskette by default. 

If your hardware supports an HSC configuration, you must build a new diskette to 
enable the HSC remote boot commands. 

To build the diskette, follow these steps: 

1. Invoke the mkconsole program by typing: 

# etc/mkconsole 

The program assumes that /vmunix is the running kernel. When you run the 
program, mkconsole prompts you to remove the RX50 diskette from the drive 
and insert a blank RX50 diskette in the same drive. 

2. Replace the RX50 diskette with a blank write-enabled RX50 diskette and press 
the RETURN key. The program responds with a brief message to explain its 
activity. At completion, the system prompt appears. 
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After building the new diskette, your system is able to boot a remote HSC device. 


3.12.5 Updating the VAX 8500, VAX 8530, VAX 8550, VAX 8700, VAX 8800, 
and VAX 8810 Boot Command Files 

For each of these processors, there are several boot command files that you can use to 
start your system. The format of these command files is the same. Each command 
file contains setup and initialization commands, several DEPOSIT statements, and 
several startup statements. 

The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program, VMB. EXE, to 
determine which device is to be booted. All of the DEPOSIT statements require 
hexadecimal values. 

The GPRs and their meanings are: 

• RO - Boot device type code 

• R1 - Processor-specific adapter information 

• R2 - Controller number 

• R3 - Unit number of the boot device 

• R4 - Logical boot block number 

• R5 - Boot control flags 

Appendix B contains a complete listing of the values for each of these registers. Any 
of the register entries in these files can be changed, but the Rl, R3, and R5 registers 
are the ones most likely to change. 

Example 3-2 shows a sample boot command file (bdara. com) for a VAX 8700 
processor. 

Example 3-2: Sample VAX 8700 Boot Command File 

SET VERIFY 
! BDARA.COM 
! REV 1.0 

! COMMAND PROCEDURE TO BOOT ULTRIX FROM A BDA DISK. 

! NEXT_PRIMARY is expected to point to the CPU that is to be used 
! as the primary CPU. 

! The following register deposits must be done before executing this 
! command procedure or must be edited to correspond to the hardware 
! configuration: 

! Rl - Bus address information 
! R3 - device unit number 

SET TERMINAL OPAO i Set up logging 

SET DEFAULT HEXADECIMAL,PHYSICAL,LONGWORD 


INITIALIZE 
DEPOSIT RO 21 
!DEPOSIT Rl 00 

DEPOSIT R2 0 


Init primary 

BDA boot device type code 
Boot device bus address: 

<3:0>=BI node #, <5:4>=BI # 

<31:24>=optional controller letter specifier 
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Example 3-2: (continued) 


!DEPOSIT R3 %D0 
SET DEFAULT HEXADECIMAL 
DEPOSIT R4 0 
DEPOSIT R5 lOOOB 


FIND/MEM 


Unit # of drive, decimal radix 

Reset radix 

Not applicable 

bits purpose 

<0> ask for boot image name. 

<1> boot single user 

<3> boot ultrix 

<16> ignore memory soft errors. 

Find 64kb of working memory; set cold 


IF NOT $STATUS THEN @EXIT 
EXAMINE SP 
LOAD/MAINMEMORY/START=@ VMB.EXE 
START @ 


Start bit 

Boot if find was successful 
Show address of working memory + %X200 
Load VMB into good mem + %X200 
Start executing VMB 


The steps to update the boot command files for these processors are: 

1. Exit the console mode. To do this, type a CTRL/P at the superuser prompt and 
type the word exit at the console mode prompt: 

# ICTRL/Pl 

»>exit 

$ 

The $ prompt signifies that you are out of the console mode and under control of 
the operating system running on the PRO-380. 

2. Make a copy of the bdara. com file, with the name def boo . com. For the 
8800 processor, specify the subdirectory [8800], which contains the 
bdara.com 

$ COPY [8800]bdara.com defboo.com 

For the other VAX processors, copy the bdara. com file in the system default 
subdirectory: 

$ COPY bdara.com defboo.com 


Caution 

Do not edit the bdara. com file. This file is required for future 
ULTRIX installations or may be needed to boot alternate system 
disks. 

3. Edit the def boo. com file. You must use the EDT editor as described in the 
appropriate Console Operator’s Guide. This editor is invoked with the RUN EDT 
command, followed by the file name that you want to edit: 

$ RUN EDT 

EDT> defbook.com 

The entries that you may have to change are the Rl, R3, and R5 register entries. 
At a minimum, you must remove the exclamation points (!) from the beginning 
of the Rl and R3 lines. 

The Rl register entry specifies - from the left-most bits - the following: 

- Bits 0 to 3 specify the number of the BI adapter node which is connected to 
the BUA. 

- Bits 4 and 5 specify the NBIA adapter number. 
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- Bits 6 through 31 of the R1 register must be zero. 

The R3 register specifies the unit (plug) number of the system disk drive. 

The R5 register entry should read 10008, which specifies booting the 
ULTRIX operating system to multiuser mode. 

4. Exit the defboo. com file (after making the appropriate changes) and return to 
the $ prompt. 

5. Make a copy of the defboo. com file, and name the copy askboo. com. For 
example, type: 

$ COPY defboo.com askboo.com 

$ 

The system uses the askboo.com file to boot the system in conversational 
mode. 

6. Edit the askboo.com file, using the EDT editor: 

$ RUN EDT 
EDT> askboo.com 

The only register that you change is the R5 register. The R5 register entry should 
read lOOOB. This causes the VMB.EXE program to boot the ULTRIX operating 
system to conversational single-user mode as described in Chapter 2. 

7. Exit the askboo.com file (after making the appropriate changes) and return to 
the $ prompt. 

8. Return to the console monitor prompt by running the control program: 

$ RUN CONTROL 

This command causes the system to redisplay the console monitor prompt »>. 

9. Return the console to the ULTRIX superuser prompt: 

»>set term prog 

# 

The # prompt indicates that you have returned to the ULTRIX operating system 
and can continue normal operations. You can now use the b and b ask boot 
commands to boot the system, as described in Section 3.8. 


3.12.6 Updating the VAX 8820/8830/8840 Boot Command Files 

There are boot command files for the VAX 8820/8830/8840 processors that you use 
to start your system. The format of these command files is the same. Each 
command file contains setup and initialization commands, several DEPOSIT 
statements, and several startup statements. 

The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program VMB. EXE, to 
determine which device is to be booted. All of the DEPOSIT statements require 
hexadecimal values. 

The GPRs and their meanings are: 

• RO - Boot device type code 
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• R1 - Processor-specific adapter information 

• R2 - Controller number 

• R3 - Unit number of the boot device 

• R4 - Logical boot block number 

• R5 - Boot control flags 

Appendix B contains a complete listing of the values for each of these registers. Any 
of the register entries in these files can be changed, but the Rl, R3, and R5 registers 
are the ones most likely to change. 

To update the boot command files, follow these steps: 

1. Exit the console mode. To do this, type a CTRL/P at the superuser prompt: 

# I CTRL/P I 
>>> 

The >>> prompt signifies that you are running under control of the console 
operating system. 

2. Makeacopyofthebdara.cmdfilewiththenamedefboo.cmd. Copy the 
bdara. cmd file in the system default subdirectory: 

>»COPY bdara.cmd defboo.cmd 

3. Edit the defboo. cmd file. You must use the EDT editor as described in the 
appropriate Console Operator’s Guide. This editor is invoked with the 
edit/edt command, followed by the file name that you want to edit: 

>»edit/edt defboo.cmd 

The entries that you may have to change are the Rl, R3, and R5 register entries. 
At a minimum, you must remove the exclamation points (!) from the beginning 
of the Rl and R3 lines. 

The Rl register entry specifies - from the left-most bits - the following: 

- Bits 0 to 3 specify the number of the BI adapter node which is connected to 
the BUA. 

- Bits 4 and 5 specify the NBIA adapter number. 

- Bits 6 through 31 of the Rl register must be zero. 

The R3 register specifies the unit (plug) number of the system disk drive. 

The R5 register entry should read 10008, which specifies booting the 
ULTRIX operating system to multiuser mode. 

4. Exit the defboo . cmd file (after making the appropriate changes) and return to 
the >>> prompt. 

5. Make a copy of the defboo. cmd file, and name the copy askboo. cmd. For 
example, type: 

»>COPY defboo.cmd askboo.cmd 

»> 

The system uses the askboo. cmd file to boot the system in conversational 
mode. 
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6. Edit the askboo. cmd file, using the EDT editor: 

»>edit/edt askboo.cmd 

The only register that you change is the R5 register. The R5 register entry should 
read lOOOB. This causes the VMB.EXE program to boot the ULTRIX operating 
system to conversational single-user mode as described in Chapter 2. 

7. Exit the askboo. cmd file (after making the appropriate changes) and return to 
the >» prompt. 

8. Return the console to the superuser prompt: 

»>set term prog 

# 

The # prompt indicates that you have returned to the operating system and can 
continue normal operations. You can now use the b and b ask boot commands 
to boot the system, as described in Section 3.9. 


3.12.7 Updating the VAX 8600 and VAX 8650 Console RL02 Disk 

The procedure in this section describes how to create boot command files that will 
boot the current running system disk. This procedure assumes that the /usr file 
system is mounted. 

To update the VAX 8600 or the VAX 8650 console RL02 disks, run the 
mkconsole command. This command assumes that /vmunix is the running 
kernel. Type: 

# etc/mkconsole 

The mkconsole command writes the ULTRIX support files, which include the 
defboo . comand askboo. com files, to the console RL02 disk. 

You can now use the b and b ask commands to boot the system, as described in 
Section 3.10. 

3.13 Booting a DECstation 3100 or a DECstation 2100 

The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, or the network. 

3.13.1 Setting Console Environmental Variables 

You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 

To set the boot path variable, use this syntax: 

setenv bootpath rz(#,#,#)vmunix 

The bootpath variable sets the default boot device. The first # specifies the SCSI 
controller number. The default value is 0. The second # specifies the unit number of 
the system disk drive. The third # specifies the disk partition. The default value is 0. 
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For example, to set the default boot device to an rz disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as: 

»setenv bootpath rz (0,1,0) vmunix 

To set the bootmode variable, use this syntax: 

setenv bootmode variable 

The boot mode variable enables or disables automatic boot operation. To enable 
automatic boot to multiuser mode using the bootpath variable, set the bootmode 
variable to a. For example: 

»setenv bootmode a 

To disable the automatic boot operation (that is, to suppress an automatic boot to 
multiuser mode after the RESET button has been depressed or as the result of a 
power on), set the bootmode variable to asterisk (*). For example: 

»setenv bootmode * 

You can also set other console environmental variables. To get a listing of all of the 
variables, type: 

>>printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


3.13.2 Booting a System Disk 

You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 

• To boot the default disk or the system disk to single-user mode, type: 

»boot 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 

• To boot the default disk or the system disk to multiuser mode, type: 

»auto 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 

• To boot an alternate disk or kernel image to single-user mode, type: 

» boot -f rz(0,#,0)vmunix.new 

• To boot an alternate disk or kernel image to multiuser mode, type: 

» setenv bootpath rz(0,#,0)vmunix.new 
» auto 


For additional information on startup modes, see Chapter 2. 
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3.13.3 Booting a TK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TK50 tape. After installing the TK50 boot tape, type: 

>>test -c 

The console subsystem displays information that identifies the unit number of your 
tape drive and various other assignments. (Use this information to define the tape 
drive unit number (#) when you enter the boot command later on.) 

After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format: 

boot -f tz(0,^ 

For example, to boot a SCSI tape (tz) at controller 0, drive 5, type: 

>>boot -f tz(0,5) 

3.13.4 Booting from the Network 

You boot from the network when you are: 

• Booting a diskless system 

• Initiating an installation from a remote server 

• Booting a standalone kernel from a remote server, in order to perform system 
management tasks 

To boot the system from the network, enter this command: 

»boot -f mopO 

3.13.5 Setting the Defauit Boot Device 

You set the default boot device when you want to change the boot default system 
disk permanently. 

To do this, follow these steps: 

1. Shut down your system. 

2. When the console prompt (») appears, type the command, using this format: 

setenv bootpath rz(#,#,^vmunix 

The bootpath variable sets the default boot device. The first # specifies the 
SCSI controller number. The default value is 0. The second # specifies the unit 
number of the system disk driver. The third # specifies the disk partition. The 
default value is 0. 
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For example, to set the default boot device to an rz disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as: 

»setenv bootpath rz (0,1,0) vmunix 

3. Use the boot command to reboot your new system disk to single-user mode. 

4. Use the auto command to reboot your new system disk to multiuser mode. 


3.14 Booting the DECstation 5000 Series and the DECsystem 
5900 

The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, CDROM or the network. 

Note 

If your ROMs are upgraded to TCF ROMs after ULTRIX has been 
installed, the bootpath environment variable is no longer used and you 
must set the boot environment variable. 


3.14.1 Determining the Default Slot Number 

To determine the default slot numbers for the controllers and devices configured on 
your system, type the following command at the console prompt: 

>> cnfg 

The cnfg command shows the options present on your system, displaying output 
like the following: 


7:KN0Z-AA 

DEC 

V5.3a 

TCFO 

(16 MB) 

6:PMAD-AA 

DEC 

V5.3a 

TCFO 

(enet:08) 

5:PMAZ-AA 

DEC 

V5.3a 

TCFO 

(SCSI=7) 

2:PMAZ-AA 

DEC 

V5.3a 

TCFO 

(SCSI=7) 

1;PMAG-AA 

DEC 

V5.3a 

TCFO 



The first column always displays slot numbers of the device controllers; the slot 
numbers differ with each configuration. 

Table 3-1 lists the boot information for default SCSI devices that are attached to the 
controllers identified by the letters "SCSI" in the fifth column of the cnfg command, 
display. Table 3-2 lists the boot information for default network devices that are 
attached to the controllers and identified by the letters "enet" in the fifth column of 
the cnfg command display. 
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Table 3-1: Default SCSI Devices for the DS5000-200 


Boot 

Devices 

cnfg 

Controller 

Identifiers 

Device 

Name 

Default 

Slot 

Number 

Default 

Controller 

Number 

Tape 

SCSI 

tz 

5 

0 

Disk 

SCSI 

rz 

5 

0 

CDROM 

SCSI 

rz 

5 

0 


Table 3-2: Default Network Devices for the DS5000-200 


Boot 

cnfg 

Device 

Default 

Default 

Devices 

Controller 

Name 

Slot 

Controller 


Identifiers 


Number 

Number 

Network Options 

enet 

-- 

6 

0 


3.14.2 Determining the Boot Device Number 

To determine the boot device number, use the cnfg command with the following 
syntax: 

cnfg slotjiumber 


For example, to determine the device number of a SCSI disk drive with a controller 
number of 0 and a slot number of 5, type the following command: 

» cnfg 5 

In the command’s display, the disk drive is identified by the letters "rz," followed by 
the device number (rz3, in the following example): 


5: 

PMAZ-AA 

DEC 

V5.3a 

TCFO 


(SCSI = 7) 


DEV 

PID 


VID 

REV 

SCSI DEV 



rz3 

RZ56 

(C)DEC 

DEC 

0200 

DIR 

SEQ 


With this information, you are now able to boot your system or set your system’s 
environmental boot variable, because you know that the slot number of controller 0 is 
5, the device name is rz, and device number of the boot device attached to that 
controller is 3 (rz3). 
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Note 


If the cnf g slotjiumber command shows that you have multiple devices 
configured on the same controller, you will have to know which device is 
the boot device. If you do not know which device is the boot device, 
consult your system administrator. 


3.14.3 Setting the Console Environmental Variables 

The following sections discuss how to set the console environmental variables for the 
boot and halt act ion commands. To get a listing of the variables, type: 

>> printenv 

For more information about the variables and for instructions on how to set each, see 
your hardware manual. 

3.14.3.1 Setting the System Disk Boot Variable 

You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables, depending on whether you will 
be booting from the system disk or from the network. 

The boot environmental variable sets the default boot device. To set the boot 
variable for the system disk, use the set env command with the following syntax: 

setenv boot slot_number/device_name_number/unix_kernel [ -a ] 

Replace slotjiumber with the slot number of the disk controller that is to be the 
default boot device. Replace device jiamejiumber with the name and the device 
number of the default boot device. Replace unixjcernel with the pathname of the 
UNIX kernel that is to be the default kernel. 

Use the -a switch to enable booting to multiuser mode by default. 

Multiuser Mode — To set the boot environmental variable to boot to multiuser 
mode by default, you must set the -a switch and surround everything after the boot 
variable in double quotation marks ("). 

For example, to set the default boot device to an rz disk at slot 0, drive 1, with 
vmunix as the default kernel, and to set the default to boot to multiuser mode, type 
the following command: 

» setenv boot "O/rzl/vmunix -a" 

Single-user Mode — To set the boot environmental variable to boot to single- 
user mode by default, do not set the -a switch. 

For example, to set the default boot device to an rz disk at slot 0, drive 1, with 
vmunix as the default kernel, and to set the default to boot to single-user mode, type 
the following command: 

>> setenv boot O/rzl/vmunix 
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3.14.3.2 Setting the Network Boot Variable 

The boot variable sets the default boot device. To set the boot variable for the 
network, use the setenv command with the following syntax: 

setenv boot slot_number/mop [ -a ] 

Replace slotjiumber with the slot number of the module that is to be the default boot 
device. 

Use the -a switch to enable booting to multiuser mode by default. 

Multiuser Mode - To set the boot environmental variable to boot to multiuser 
mode by default, set the -a switch and surround everything after the boot variable 
in double quotation marks ("). 

For example, to set the default boot device to the network at slot 0, and to set the 
default to boot to multiuser mode, type the following command: 

>> setenv boot "0/mop -a" 

Single-user Mode — To set the boot environmental variable to boot to single- 
user mode by default, do not set the -a switch. For example, to set the default boot 
device to the network at slot 0, and to set the default to boot to single-user mode, 
type the following command: 

» setenv boot 0/mop 


3.14.3.3 Setting the haltaction Variable 

The haltaction variable enables or disables automatic boot operation. To set the 
haltaction variable, use the setenv command with the following syntax: 

setenv haltaction variable 

To enable automatic boot mode using the boot variable, set the haltaction 
variable to b by typing the following command: 

» setenv haltaction b 

To disable the automatic boot operation (that is, to suppress an automatic reboot after 
the reset button has been depressed or when power to the machine is turned on), set 
the haltaction variable to h by typing the following command: 

>> setenv haltaction h 

To force the system to restart when the reset button is pressed, and thereby do a 
memory dump, set the haltaction variable to r by typing the following 
command: 

» setenv haltaction r 


3.14.4 Booting from a Disk 

You can boot the system disk or an alternate disk or alternate kernel to either single- 
user or multiuser mode. 
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3.14.4.1 


3.14.4.2 


3.14.5 


3.14.6 


Booting from the System Disk 

To boot the system disk to single-user or multiuser mode, type the following 
command: 

>> boot 

The system boots the device that was set in the boot console environmental 
variable. 

Booting from an Alternate Disk or Kernel 

To boot an alternate disk or kernel image to single-user or multiuser mode use the 
boot command with the following syntax: 

boot slot_number/device_name_number/unix_kernel [ -a ] 


Replace slotjiumber with the slot number of the controller attached to your boot 
device. Replace device jiamejiumber with the name and the number of the boot 
device. Replace unixjcernel with the pathname of the alternate kernel. Use the -a 
switch and surround everything after the boot variable with double quotes to enable 
booting to multiuser mode. 

For example, to boot an alternate kernel at slot 0, drive 5 to multiuser mode, type the 
following command: 

>> boot "0/rz5/vmunix.new -a" 


Booting from a TK50 Tape 

When doing an installation or, when booting the standalone kernel for system 
management tasks, you may have to boot the system from a TK50 tape. After 
installing the TK50 boot tape, determine the device number of the drive for your 
device by following the instructions in Section 3.14.2. 

For example, if the TK50 is attached to a SCSI controller at slot 5 (this is the most 
common configuration), type the following command: 

>> cnfg 5 

Use the boot command with the following syntax to boot your system: 
boot slot_numberAzdevice_number 

Replace slotjiumber with the slot number of the tape controller. Replace 
device jiumber with the device number of the SCSI tape drive from which you are 
booting. 

For example, to boot a SCSI tape (tz) at slot 5, drive 5, type the following 
command: 

» boot 5/tz5 


Booting from a CDROM 

To boot the system, load the CDROM into the drive and wait for the drive to be on 
line and ready. 

Determine the number of the drive for your device, as described in Section 3.14.2. 


3-40 Processor-Specific Boot Commands 



For example, if the CDROM is attached to a SCSI controller at slot 5 (this is the 
most common configuration), type the following command: 

>> cnfg 5 

A display appears that shows what is assigned to each device number on your 
system. 

Use the boot command with the following syntax to boot your system: 
boot slot_number/rzdevice_number/vmunix [ -a ] 

Replace slot-number with the slot number of the CDROM controller. Replace 
device-number with the device number of your RRD40 optical disk drive. 

Use the -a switch and surround everything after the boot variable with double quotes 
to enable booting to multiuser mode. 

For example, to boot the system to multiuser mode from RRD40 optical disk drive 
number 4 on slot number 1, type the following command: 

>> boot "l/rz4/vmunix -a" 


3.14.7 Booting from the Network 

You boot your system from the network when you do one of the following: 

• Boot a diskless system 

• Initiate an installation from a remote server 

• Boot a standalone kernel from a remote server to perform system management 
tasks 

To boot the system fi'om the network, use the boot command with the following 
syntax: 

boot slot_number/mop [ -a ] 

Replace slotjiumber with the slot number of the network controller. Use the -a 
switch and surround everything after the boot variable with double quotes to enable 
booting to multiuser mode. 

For example, to boot from the network to multiuser mode on slot number 6, type the 
following command: 

>> boot "6/mop -a" 

3.15 Booting the DECstation 5400 

The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, or the network. 

3.15.1 Setting Console Environmental Variables 

You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 

To set the bootpath variable, use the setenv command with this syntax: 

setenv bootpath rz(#,#,y^Ovmunix 
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The bootpath variable sets the default boot device. The first number sign specifies 
the controller number; the default value is 0. The second number sign specifies the 
unit number of the system disk drive. The third number sign specifies the disk offset; 
the default value is 0. 

For example, to set the default boot device to an rf disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as follows: 

>>setenv bootpath rf (0,1, 0) vinunix 

To set the bootmode variable, use the setenv command with this syntax: 

setenv bootmode variable 

The bootmode variable enables or disables automatic boot operation. To enable 
automatic boot to multiuser mode using the bootpath variable, set the haltaction 
variable to a. For example: 

>>setenv haltaction a 

To disable the automatic boot operation (that is, to suppress an automatic reboot after 
the RESET button has been depressed or when power to the machine is turned on), 
set the bootmode variable to asterisk (*). For example: 

»setenv bootmode * 

To force the system to restart when the reset button is pressed, and thereby do a 
memory dump, set the bootmode variable to r. For example: 

>>setenv bootmode r 


You can also set other console environmental variables. To get a listing of all of the 
variables, type: 

>>printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


3.15.2 Booting a System Disk 

You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 

• To boot the default disk or the system disk to single-user mode, type: 

»boot -s 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 
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• To boot the default disk or the system disk to multiuser mode, type; 

»boot 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 

• To boot an alternate disk or kernel image to single-user mode, type: 

» boot -s -f tm(0,#,0)vmunlx.new 

• To boot an alternate disk or kernel image to multiuser mode, type: 

» boot -f tm(0,#,0)vmunix.new 


For additional information on startup modes, see Chapter 2. 


3.15.3 Booting a TK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TK50 tape. After installing the TK50 boot tape, to 
invoke the console type: 

>>maint 


When the console prompt (»>) appears, type this command: 
»>show devices 


The console subsystem displays information that identifies the unit number of your 
tape drive and various other assignments. Use this information to define the tape 
drive unit number (#) when you enter the boot command later on. Type this 
command to return to the RISC console: 

>»exit 

After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format; 

boot -f tm(0,^ 

For example, to boot a tape (tm) at controller 0, drive 5, type; 

>>boot -f tm(0,5) 


3.15.4 Booting from the Network 

You boot from the network when you are: 

• Booting a diskless system 

• Initiating an installation from a remote server 

• Booting a standalone kernel from a remote server in order to perform system 
management tasks 


Processor-Specific Boot Commands 3-43 



To boot the system from the network, enter this command: 

»boot -f mopO 


3.15.5 Setting the Default Boot Device 

You set the default boot device when you want to change the boot default system 
disk permanently. 

To do this, follow these steps: 

1. Shutdown your system. 

2. When the console prompt (») appears, type the command, using this format: 

setenv bootpath rf(#,#,#)vmunlx 

The bootpath variable sets the default boot device. The first # specifies the 
controller number. The default value is 0. The second # specifies the unit 
number of the system disk driver. The third # specifies the disk offset. The 
default value is 0. 

For example, to set the default boot device to an rf disk at controller 0, drive 1, 
offset 0, you would set the bootpath variable as: 

»setenv bootpath rf <0,1, 0) vmunix 

3. Use the boot -s command to reboot your new system disk to single-user mode. 

4. Use the boot command without the single user option to reboot your new 
system disk to multiuser mode. 


3.16 Booting the DECsystem 5810/5820/5830/5840 

The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk or tape. 

3.16.1 Setting Console Environmental Variables 

You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 

To set the bootpath variable, use this syntax: 

setenv bootpath ra{/x0slot-number/bnode-number/cCI-number,^,^ym{in\x 


The bootpath variable sets the default boot device. Replace slot-number with 
the slot number of your XMI-to-BI bus adapter (XBI). Replace node-number with 
the node number on the XBI where your controller is located. Replace Cl-number 
with the Cl node number. The first # specifies the unit number of the system disk 
drive. The second # specifies the disk offset. The default value is 0. 

For example, to set the default boot device to an ra disk with an HSC controller 
connected to Cl slot number 4, and a BI adapter in slot E (hex) drive 1, partition 0, 
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you would set the bootpath variable as: 

»setenv bootpath ra (/x0xe/b4/c6,1, 0) vmunix 

You can also set other console environment variables. To get a listing of all of the 
variables, type: 

>>printenv 

For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


3.16.2 Booting a System Disk 

You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 

1. To boot the default disk or the system disk to single-user mode, type: 

»boot -s 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 

2. To boot the default disk or the system disk to multiuser mode, type: 

»boot 

The system boots the device that was set in the bootpath console 
environmental variable described previously. 

3. To boot an alternate disk or kernel image to single-user mode, type: 

» boot -s -f ra(fxsiot-number/b node-number /c Cl-number,^,0)wmun]x.new 

4. To boot an alternate disk or kernel image to multiuser mode, type: 

» boot -f ra{/xslot-number lb node-number Ic Cl-number, #,0)vmunix.new 


For additional information on startup modes, see Chapter 2. 

3.16.3 Booting a TK50 Tape 

When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TK50 tape. After installing the TK50 boot tape, type: 

»maint 

to invoke the console. When the console prompt (»>) appears, type this command: 
>>show config 

The console subsystem displays information that identifies what is assigned to each 
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slot number on your system. The display looks like this: 



Type 


Rev 

1+ 

KN58A/A 

(8081) 

0000 

2 

KN58A/B 



9+ 

MS62A 

(4001) 

0002 

E+ 

DWMBA/A 

(2001) 

0002 

XBI 

E 



1 + 

DWMBA/B 

(2107) 

OOOA 

2 + 

KDB50 

(OlOE) 

131C 

4 + 

CIBCA 

(0108) 

41C2 

6 + 

TBK70 

(410B) 

0307 

C+ 

DEBNI 

(0118) 

0100 


Record the slot number of your XBI adapter, which is hexadecimal E in the example. 
Also record the node number of your TBK70 controller, which is 6 in the example 
(Do not include the plus (+) sign that appears in the output.) 

Type this command to return to the RISC console: 

>>>exit 


After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format: 

boot -f \ms{/xOxslot-number/bnode-number,unit-number) 


Replace slot-number with the slot number of your XMI-to-BI bus adapter (XBI). 
Replace node-number with the node number of the XBI where your TBK70 
controller is located. Replace unit-number with the unit number of your TBK70 
controller. The unit number is always the same as the node number on the XBI 
where your TBK70 controller is located. 

For example, to boot the system from XBI slot E (hex) for a TBK70 controller 
located on XBI node 6 type: 

>>boot -f tms(/x0xe/b6,6) 


3.16.4 Setting the Default Boot Device 

You set the default boot device when you want to change the boot default system 
disk nermanentlv 

-JT- J ' 

To do this, follow these steps: 

1. Shutdown your system. 

2. Set the default boot device by setting the boot path variable. For information 
on setting the bootpath variable, see Section 3.16.1. 

3. Use the boot -s command to reboot your new system disk to single-user mode. 

4. Use the boot command without the single user option to reboot your new 
system disk to multiuser mode. 
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The Standalone ULTRIX Environment 


The standalone ULTRIX environment is a diskless environment that has its miniroot 
file system within the data space of the running kernel. It is used to initiate ULTRIX 
installations. 

The primary purpose of the standalone ULTRIX environment is to support the initial 
phases of an installation, which include selecting input and output devices, as well as 
restoring the root file system image to the target system disk. Throughout the 
installation process, full ULTRIX device drivers are used. 

A secondary purpose of the standalone ULTRIX environment is to support system 
management activities. These activities include: 

• Restoring a damaged root file system 

• Checking the consistency of the root file system 

• Restoring the boot block image 

• Performing disk maintenance operations 

The commands included in the standalone ULTRIX environment are those commands 
that assist in recovering from root file system corruption, and those that help perform 
general file system and disk maintenance tasks. You should therefore consider the 
standalone ULTRIX environment a limited and intentionally small environment that 
does not perform like a full 

operating system environment. System management activities in the standalone 
ULTRIX environment should be performed by those individuals who have extensive 
ULTRIX or UNIX operating systems experience. 

The sections in this chapter: 

• Explain how to invoke the standalone ULTRIX environment 

• Identify some of the more commonly used functional capabilities 

• Describe how to extend the standalone ULTRIX environment so that additional 
commands can be used. 


4.1 Invoking the Standalone ULTRIX Environment 

The media and the commands that you use to invoke the standalone ULTRIX 
environment are dependent on the type of processor that you are using. These media 
and commands are identified and described in the Guide to Installing ULTRIX. 

As part of the installation, the system prompts you to select one of three options: 

• Basic Installation 

• Advanced Installation 

• System Management 




Choose the third item, System Management, to invoke the Standalone ULTRIX 
Environment. The system responds by placing the system in single-user mode and 
by displaying the # shell prompt. 


4.2 Standalone ULTRIX Environment Capabilities 

The standalone ULTRIX environment enables you to perform all of the typical 
system management activities. The only difference is that, in some cases, you have 
to use system primitives instead of the more advanced system commands. For 
example, to make a new file system, you must use the mkf s command instead of the 
newf s command. This is because of the space limitation imposed on the standalone 
ULTRIX environment. 

A limitation of the standalone ULTRIX environment is that only peripheral devices 
connected to controllers that have been assigned standard, fixed, CSR addresses are 
accessible when making special device files. At boot time, the system does not 
configure controllers assigned floating CSR addresses. When the special device files 
have been created with the MAKEDEV command, you have access to the functional 
capabilities of the standalone ULTRIX environment. These functional capabilities 
include the ability to do the following: 

• Repair corrupted file systems with the f sck command 

• Create new file systems with the mkf s command 

• Restore the boot block with the dd command 

• Restore file systems with the restore command 

• Maintain disks with the rzdisk or radisk commands 

• Mount other disks and file systems with the mount command 

An example of the standalone ULTRIX environment’s functional capability is 
described in the Guide to Backup and Restore. The description explains how to 
restore the root file system after a catastrophic event has occurred. 

4.3 Extending the Standalone ULTRIX Environment 

If you find that the commands and utilities provided by the standalone ULTRIX 
environment do not completely meet your needs, you can extend the environment to 
include access to other commands. To extend the standalone ULTRIX environment, 
perform the following steps: 

1. Make the device special files for the device that contains the target commands. 

To do this, change directories as follows: 

# cd /dev 

After changing directories, use the following syntax to create the special device 
files: 

MAKEDEVdewce 
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2. Mount the device. For example, to mount the /mnt file system, use the 
following format: 

# mount device /mnt 

This enables you to access any of the commands or files on that device. To see 
what commands and files are available, type: 

# Is /mnt 

The system responds by displaying the contents of /mnt. 
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Device Mnemonics 


This appendix identifies and defines the mnemonics that are used to attach any 
hardware or software device to your system. The mnemonics are used by the 
/dev/MAKEDEV shell script to create the character or block special files that 
represent each of the devices. The mnemonics also appear in the system 
configuration file, as described in the Guide to Configuration File Maintenance. 

Table A-1 lists the mnemonics in nine categories: generic, systems, consoles, disks, 
tapes, terminals, modems, printers, and others. The generic category lists the 
mnemonics of a general nature and includes memory, null, trace, and tty devices. 

The systems category lists the mnemonic for DECstation system setup. The consoles 
category lists the system console devices that the ULTRIX operating system uses. 
The disks, tapes, terminals, modems, and printers categories identify the appropriate 
mnemonics for those devices. The others category lists the mnemonic for DECstation 
devices. 

The description heading in Table A-1 identifies the corresponding device name. It 
does not define the mnemonic’s use. For detailed information on the use of each 
mnemonic in relation to both the MAKEDEV script and the system configuration file, 
refer to the reference pages in Section 4 of the ULTRIX Reference Pages. If on-line 
reference pages are available, you can also use the man command. For instance, 
enter the following command at the system prompt to display the reference page for 
the Small Computer System Interconnect (SCSI) disk controller driver: 

% man rz 

Where appropriate, the SYNTAX section of the reference page defines the device’s 
syntax as it should appear, in the con fig file. Refer to /dev/MAKEDEV for 
additional software device mnemonics that MAKEDEV uses. Refer to MAKEDEV(8) in 
the ULTRIX Reference Pages for a description of the MAKEDEV utility. 

Table A-1 uses the convention of an asterisk (*) beside a mnemonic and a question 
mark (?) beside a device name to mean a variable number. The value of the variable 
number is dependent on the particular device. 




Table A-1: Devices Supported by MAKEDEV 


Category 

Mnemonic 

Description 

Generic 

boot* 

Boot and std devices by cpu number; for example, boot750 


audit 

Audit log device 


drum 

Kernel drum device 


mvax* 

All MicroVAX setups; for example, mvax2000 


vaxstation* 

A VAXstation 2000 setup; for example, vaxstation2000 


std 

Standard devices with all console subsystems 


errlog 

Error log device 


kUmem 

Kernel Unibus/Q-bus virtual memory 


kmem 

Virtual main memory 


mem 

Physical memory 


null 

A null device 


trace 

A trace device 


tty 

A character terminal device 


local 

Customer-specific devices 

Systems 

DECstation 

A DECstation setup (for example, a DECstation 3100) 

Consoles 

console 

System console interface 


crl 

Console RL02 disk interface for VAX 8670 


cs* 

Console RX50 floppy interface for VAX 8770 


ctu* 

Console TU58 cassette interface for VAX 11/725/730/750 


cty* 

Console extra serial line units for VAX 8770 


cfl 

Console RXOl floppy interface for 11/787 


ttycp 

Console line used as auxiliary terminal port 

Disks 

hp* 

MASSBUS disk interface for RM77 drives and RP77 devices 


ra* 

UNIBUS/Q-bus/BI/HSC/DSSI MSCP disk controller interface 


rb* 

UNIBUS IDC RL02 disk controller interface 
for RB77 drives 


rd* 

VAXstation 2000 and MicroVAX 2000 RD type drives 


rz 

SCSI disks (for example, the RZ56) 


rk* 

UNIBUS RK77 disk controller interface 


rl* 

UNIBUS/Q-bus RL77 disk controller interface 


rx* 

VAXstation 2000 and MicroVAX 2000 RX type drives 


fd 

Floppy Disk (for example, the RX26) 

1 

ik 

iiiU ' 

MASSBUS magiapc interface (for example, the TU7S) 


tms* 

UNIBUS/Q-bus/BI/HSC/DSSI TMSCP tape controller interface 


rv* 

UNIBUS/Q-bus/BI TMSCP optical disk 


ts* 

UNIBUS/Q-bus TSl 1/TS05/TU80 magtape interface 


tu* 

TE16/TU45/TU77 MASSBUS magtape interface 


st* 

VAXstation 2000 and MicroVAX 2000 TZK50 
cartridge tape 


tz* 

SCSI tapes (for example, the TZU50) 

Terminals 

cxa* 

C^-bus cxa 16 


cxb* 

(^bus cxbl6 


cxy* 

(3“bus cxt08 


dfa* 

(^bus DFAOl comm multiplexer 


dhq* 

Q-bus DHQ 11 comm multiplexer 


dhu* 

UNIBUS DHU 11 comm multiplexer 


dhv* 

(5-bus DHV 11 comm multiplexer 


dmb* 

BI DMB32 comm multiplexer including dmbsp 


serial printer/plotter 
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Table A-1: (continued) 


Category 

Mnemonic 

Description 


dhb* 

BI DHB32 comm multiplexer 


dmf* 

UNIBUS DMF32 comm multiplexer including dmfsp 
serial printer/plotter 


dmz* 

UNIBUS DMZ32 comm multiplexer 


dz 

UNIBUS DZl 1 and DZ32 comm multiplexer 


sh* 

MicroVAX 2000, 8 serial line expansion option 


ss* 

VAXstation 2000 and MicroVAX 2000 basic 

4 serial line unit 


fc* 

VAXstation 60 basic 4 serial line unit 


dzq* 

Q-bus DZQ 11 comm multiplexer 


dzv* 

Q-bus DZVll comm multiplexer 


Ita* 

Sets of 16 network local area terminals (LAT) 


pty* 

Sets of 16 network pseudoterminals 


qd* 

Q-bus VCB02 (QDSS) graphics controller/console 


qv* 

Q-bus VCBOl (QVSS) graphics controller/console 


sm* 

VAXstation 2000 monochrome bitmap graphics/console 


sg* 

VAXstation 2000 color bitmap graphics console 


lx 

VAXstation 8000 color high-performance 3D graphics 


fg* 

VAXstation 60 color bitmap graphics/console 

Modems 

dfa* 

DFAOl integral modem communications device. 

Printers 

dmbsp* 

BI DMB32 serial printer/plotter 


dmfsp* 

UNIBUS DMF32 serial printer/plotter 


Ip* 

UNIBUS LPl 1 parallel line printer 


Ipv* 

Q-bus LPll parallel line printer 

Packet filter 

pfilt 

Packet filter devices; set of 64 

Other 

pm* 

mono/color bitmap graphics/mouse/modem 
/printer/terminals for DECstation 3100 
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General Purpose Register Use by VMB.EXE 

(VAX Only) 




The ULTRIX operating system uses I/O device drivers provided in the VMS Virtual 
Memory Bootstrap (VMB) program. The VMB program evaluates the contents of 
general purpose registers (GPRs) RO through R5 to determine which device is to be 
booted. Where appropriate, installation procedures are set up to build default boot 
command files to bootstrap the system disk. If you wish to tailor the contents of 
boot command files, you can edit and replace them as necessary. This appendix is 
provided as a reference to show the use of the GPRs by the VMB program. 

The following list defines the possible contents of the RO through R5 registers. 
Values enclosed in < > signs define the bit positions for a particular parameter. For 
example: <07:00> means from bits 0 to 7. The notation MBZ means that the value 
must be zero. 


Note 

Input Parameters : (Registers expect hex values) 
• RO: 


- <07:00> boot device type code (RPB$B_DEVTYP) 


Hex Value Device 

0 MASSBUS device 

(RM02/3,RP04/5/6/7,RM80) 

1 RK06/7 

2 RLOl/2 

3 IDC(almost an RA80) on 
11/730 

11 UDA-50 (note: values I - IF 

are reserved for UNIBUS 
devices) 

20 HSC on Cl 

21 BDA on BI 

40 Console block storage device 


- <15:08> reserved for future expansion 

- <31:16> device class dependent (RPB$W_R0UBVEC) 

• UNIBUS - optional vector address; 0 implies use the default vector 

• MASSBUS - not used 




• Rl: Boot device’s bus address 


11/780 & 11/730 

<31:04> MBZ 

<03:00> TR number of adapter 

11/750 

<31:24>MBZ 
<23:00> address of the I/O 
page for the boot device’s 
adapter 

8600 

<31:06> MBZ 
<05:04> A-bus Adapter 
number 

<03:00> TR number of the 
adapter 

8800 

<31:06> MBZ 
<05:04> NBIA Adapter 
number 

<03:00> BI node number of 
the adapter 


• R2: 

All controllers: <31:24> controller letter 

designator (optional) 

UNIBUS: <23:18>MBZ<17:00> 

UNIBUS address of the 
device’s CSR 

MASSBUS: <23:04> MBZ <03:00> 

adapter’s controller/formatter 
number 

Cl: <23:08> MBZ <07:00> HSC 

node number (station address) 

• R3: Boot device unit number 

• R4:<31:0>MBZ 

• R5: Software boot control flags. The value-1 is reserved. 

The following table defines the software boot control flags used by the ULTRIX 
operating system. The first column of the table contains a comment about the 
ULTRIX operating system’s use of that control flag. If.this column is blank, the flag 
is not required by the ULTRIX operating system. The second column defines the bit 
number of the register. The third column defines the control flag. 

Table B-1: Software Boot Control Flags 


Comment 

Bit 

Meaning 

OPTIONAL 

0 

RPB$V_CONV 

(RB_ASKNAME) 


Conversational boot. This bit will force ULTRIXBOOT to prompt the user 
for an image name which would presumably be different from the default 
vmunix. If the DIAG is also on, then the user is prompted for the 
diagnostic supervisor image name. 


B-2 General Purpose Register Use by VMB.EXE (VAX Only) 





Table B-1: (continued) 


Comment 


Bit Meaning 


OPTIONAL 

(RB_SINGLE) 


REQUIRED 

OPTIONAL 


REQUIRED 


1 RPB$V_DEBUG 

If this flag is set, the ULTRIX kernel image will be booted to single-user 
mode. 

2 RPBSVJNIBPT 

Initial breakpoint. If RPB$V_DEBUG is set, VMS executes a BPT 
instruction immediately after enabling mapping. 

3 RPB$V_BBLOCK 

Secondary boot from boot block. Secondary bootstrap is a single 512-byte 
block, whose LBN is specified in R4. R4 must be 0 for ULTRIX. 

4 RPB$V_DIAG (RB.LOADDS for ULTRIX) 

Diagnostic boot. Causes ULTRIXBOOT to load the appropriate diagnostic 
supervisor by CPU type. The default path is /field/e?saa.exe, where the 
partition is specified in bits <31:28> of this register. 

5 RPB$V_BOOBPT 

Bootstrap breakpoint. Stops the primary and secondary bootstraps with a 
breakpoint instruction before testing memory. 

6 RPB$V_HEADER 

Image header. Takes the transfer address of the secondary bootstrap image 

from that file’s image header. If RPB$V_HEADER is not set, transfers 
control to the first byte of the secondary boot file. 

7 RPB$V_NOTEST 

Memory test inhibit. Sets a bit in the PEN bit map for each page of memory 
present. Does not test the memory. 

8 RPB$V_SOLICT 

File name. VM@ prompts for the name of a secondary bootstrap file. 

9 RPB$V_HALT 

Halt before transfer. Executes a HALT instruction before transferring control 
to the secondary bootstrap. 

10 RPB$V_NOPFND 

No PFN deletion (not implemented; intended to tell VM@ not to read a file 
from the boot device that identifies bad or reserved memory pages, so that 
VM@ does not mark these pages as valid in the PFN bitmap). 

11 RPB$V_MPM 

Specifies that multiport memory is to be used for the total executive memory 
requirement. No local memory is to be used. This is for tightly coupled 
multiprocessing. 

12 RPB$V_USEMPM 

Specifies that multiport memory should be used in addition to local memory, 
as though both were one single pool of pages. 

13 RPB$V_MEMTEST 

Specifies that a more extensive algorithm be used when testing main memory 
for hardware uncorrectable (RDS) errors. 

14 RPB$V_FINDMEM 

Requests use of MA780 memory if MS780 is insufficient for booting. Used 
for 11/782 installations. 

15 RPB$V_AUTOTEST 

Used by Diagnostic Supervisor. 

16 RPB$V_CRDTEST 

Specifies that memory pages with correctable (CRD) errors NOT be 
discarded at bootstrap time. By default, pages with CRD errors are removed 
from use during the bootstrap memory test. 

<27:17> MBZ - Reserved for future expansion. 
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Table B-1: 

(continued) 


Comment 

Bit 

Meaning 

OPTIONAL 

<31:28> 

Redefines the default load file system partition. This field is used primarily 

(DIAG BOOT) 


with DIAG. The corresponding partition numbers and letters are: 

0 = a 

1 =b 

2 = c 

3 = d 

4 = e 

5 = f 

6 = g 

7 = h 

SP 


Must be set to 0x200 
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B 


D 


boot command 

alternate HSC disk, 3-16 to 3-17 
booting a system disk, 3-34, 3-42, 3-45 
booting a TK50 tape, 3-9, 3-35, 3-43, 3-45 
booting from the network, 3-35, 3-43 
building processor-specific files, 3-24 to 3-33 
changing EEPROM data, 3-28 
procedure file 

VAX 11/780, 3-11, 3-26e 
VAX 11/785, 3-11 
VAX 8600, 3-22 
VAX 8650, 3-22 
VAX 8700, 3-29e 
processor-specific, 3-1 to 3-46 
updating console disk, 3-33 
updating procedure file, 3-29 to 3-33 
updating processor-specific files, 3-24 to 3-33 
boot control flags 

reference list, B-1 to B-4 
boot device 

setting, 3-35, 3-44, 3-46 


c 


DECstation 2100 
booting, 3-33 
DECstation 3100 
booting, 3-33 
DECstation 5000 
booting, 3-36 
DECstation 5400 
booting, 3-41 
DECsystem 5810-5840 
booting, 3-44 

device mnemonics, A-1 to A-3 
reference list, A-2t to A-3t 
using with MAKEDEV, A-1 
using with man command, A-1 
diskless client 

shutting down, 1-3 


F 

file system 

checking consistency, 2-2 
unmounting, 2-2 
unmounting all, 1-1 


console diskette 

building for VAX-11/750, 3-25 
building for VAX-11/780, 3-25 to 3-27 
building for VAX-11/785, 3-25 to 3-27 
conversational mode 
invoking, 2-3 


H 

HSC configuration 
booting, 3-10, 3-14 




MicroVAX 3500 processor 
booting, 3-1 

MicroVAX 3600 processor 
booting, 3-1 

MicroVAX 3800 processor 
booting, 3-1 

MicroVAX 3900 processor 
booting, 3-1 

MicroVAX II processor 
booting, 3-1 

booting from network, 3-2, 3-4, 3-7 

multiuser mode 

booting from, 2-1 to 2-3 
booting from console mode, 2-3 
invoking from single-user mode, 2-2 to 2-3 
shutdown procedure, 1-1 to 1-2 
shutdown with reboot, 1-3 
shutdown with system halt, 1-2 


P 


Personal DECstation 
booting, 3-36 


s 


shutdown command 

shutting down multiuser mode, 1-le 
single-user mode 
booting from, 2-1 
single-user-mode 

Standalone ULTRIX environment, 4-1 to 4-3 
capabilities, 4-2 
defined, 4-1 
extending, 4-2 
invoking, 4-1 
system 

booting, 2-1 to 2-4 
halting, 1-2 

shutting down, 1-1 to 1-3 


VAX-11/750 processor 
booting, 3-9 
VAX-11/780 processor 
booting, 3-11 
VAX-11/785 processor 
booting, 3-11 
VAX 3300 processor 
booting, 3-3 to 3-4 
VAX 3400 processor 
booting, 3-3 to 3-4 
VAX 6000-410 
booting, 3-13 
VAX 6000-420 
booting, 3-13 
VAX 6000-430 
booting, 3-13 
VAX 6000-440 
booting, 3-13 
VAX 6000-450 
booting, 3-13 
VAX 6000-460 
booting, 3-13 
VAX 6000-series 
booting, 3-13 
VAX 6210 processor 
booting, 3-13 
VAX 6220 processor 
booting, 3-13 
VAX 6310 
booting, 3-13 
VAX 6320 
booting, 3-13 
VAX 6330 
booting, 3-13 
VAX 6340 
booting, 3-13 
VAX 6350 
booting, 3-13 
VAX 6360 
booting, 3-13 
VAX 8200 processor 
booting, 3-15 
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VAX 8250 processor 
booting, 3-15 
VAX 8300 processor 
booting, 3-15 
VAX 8350 processor 
booting, 3-15 
VAX 8500 processor 
booting, 3-17 
VAX 8530 processor 
booting, 3-17 
VAX 8550 processor 
booting, 3-17 
VAX 8600 processor 
booting, 3-22 
VAX 8650 processor 
booting, 3-22 
VAX 8700 processor 
booting, 3-17 
VAX 8800 processor 
booting, 3-17 
VAX 8810 processor 
booting, 3-17 
VAX 8820 processor 
booting, 3-19 
VAX 8830 processor 
booting, 3-19 
VAX 8840 processor 
booting, 3-19 
VAXserver 100 processor 
booting, 3-1 

VAXserver 3000 series processor 
booting, 3-1 
VAXstation 3520 
booting, 3-7 
VAXstation 3540 
booting, 3-7 
VAXstation processor 
booting, 3-1 

booting from network, 3-2, 3-4, 3-7 
VMB program 
GPRs and, B-1 




How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 


Electronic Orders 

To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud modem from 
anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the Electronic Store, call 
800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


International 

% 

Internal 


Call 

800-DIGITAL 

809-754-7575 

800-267-6215 


Contact 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 

Local Digital Subsidiary 

Digital Equipment of Canada 

Attn: DECdirect Operations KA02/2 

P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

SSB Order Processing - WMO/E15 
or 

Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


* For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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